Skip to content
Developers

Price API

Read-only pricing from the same rates engine the Router uses. Two endpoints: the rate of one token against another, and the rate of a token in dollars.

Pair price

Returns the mid-price of a token against another on a given network. The rate is fused from on-chain pools, centralised order books and intent flow rather than read from a single pool, so a thin or manipulated pool does not set the number on its own.

USD price

Returns the same rate expressed in dollars, triangulated across several stablecoins instead of trusting one of them as the dollar. This is the price the Router UI displays, so your values and ours agree.

Confidence

A price may carry a confidence signal describing how well supported it is by current liquidity. It is only produced when the rate is corroborated by more than one independent path; with a single path there is nothing to agree or disagree with, so no confidence is returned. Handle its absence explicitly rather than treating it as zero.

Where present, use it to decide whether to display a price, widen a spread or refuse to act on it. A low-confidence price is still a real observation, but it should not be treated as a fill.

Using it

  • Prices are for display, accounting and risk checks. They are not executable: a price does not reserve liquidity and does not account for your size.
  • To trade, use the Quote API, which solves a route for your specific amount and returns a transaction.
  • Prices move every block. Poll on an interval that matches how you use the number rather than caching it for long periods.
  • Both endpoints are key-gated.

Access

Request a key through the contact form or by emailing onecentlabs@gmail.com. See API access for how keys work.