Skip to main content

API References

Introduction​

The Price API provides access to real-time DEX prices for token pairs. It lets you access aggregated liquidity from tens of on-chain and off-chain decentralized exchange networks, across multiple blockchains. It comes with many parameters to customize your requests.

info

Price API is in beta. Its recommended use is for checking prices, not be be used for trading purposes. For example, if you plan to use this in a trading workflow that is triggered by price changes of USDC, be aware this is subject to the risk that the stablecoin may depeg.

We offer hosted versions for different EVM-compatible networks.

NetworkEndpoint
Ethereum (Mainnet)https://api.0x.org/
Ethereum (Sepolia)https://sepolia.api.0x.org/
Polygonhttps://polygon.api.0x.org/
Binance Smart Chainhttps://bsc.api.0x.org/
Optimismhttps://optimism.api.0x.org/
Fantomhttps://fantom.api.0x.org/
Celohttps://celo.api.0x.org/
Avalanchehttps://avalanche.api.0x.org/
Arbitrumhttps://arbitrum.api.0x.org/
Basehttps://base.api.0x.org/

Endpoints​

Learn more about the different endpoints of Swap API:

Authentication​

0x authenticates your API requests using your account’s API keys. Once you’re set up, ensure that you specify your key with the 0x-api-key header parameter in your requests.

You can create, access or revoke your API keys via the 0x Dashboard.

Versioning​

Each 0x HTTP API path is versioned independently using URI versioning. The format is: https://api.0x.org/<path>/<version>/<endpoint>.

For example, you can request https://api.0x.org/swap/v1/price which represents v1 of the price endpoint in the swap path. URLs not adhering to this format are not supported.

A major version bump occurs whenever a backwards incompatible change occurs to an endpoint, in which case every endpoint in that path will be on the next version. Old versions of the API will be deprecated and new features will be rolled out to them on a best-effort basis.

Addresses by Network​

The following table includes commonly used contract addresses. For a full list of our smart contract deployments address, see the 0x Cheat Sheet.

NetworkExchangeProxy AddressERC20Proxy AddressStakingProxy Address
Ethereum (mainnet)0xdef1c0ded9bec7f1a1670819833240f027b25eff0x95e6f48254609a6ee006f7d493c8e5fb97094cef0xa26e80e7dea86279c6d778d702cc413e6cffa777
Ethereum (sepolia)0xdef1c0ded9bec7f1a1670819833240f027b25eff0xf1ec7d0ba42f15fb5c9e3adbe86431973e44764c0x6acab4c9c4e3a0c78435fdb5ad1719c95460a668
Polygon0xdef1c0ded9bec7f1a1670819833240f027b25eff0x00000000000000000000000000000000000000000x0000000000000000000000000000000000000000
Binance Smart Chain0xdef1c0ded9bec7f1a1670819833240f027b25eff0x00000000000000000000000000000000000000000x0000000000000000000000000000000000000000
Optimism0xdef1abe32c034e558cdd535791643c58a13acc100x00000000000000000000000000000000000000000x0000000000000000000000000000000000000000
Fantom0xdef189deaef76e379df891899eb5a00a94cbc2500x00000000000000000000000000000000000000000x0000000000000000000000000000000000000000
Celo0xdef1c0ded9bec7f1a1670819833240f027b25eff0x00000000000000000000000000000000000000000x0000000000000000000000000000000000000000
Avalanche0xdef1c0ded9bec7f1a1670819833240f027b25eff0x00000000000000000000000000000000000000000x0000000000000000000000000000000000000000
Arbitrum0xdef1c0ded9bec7f1a1670819833240f027b25eff0x00000000000000000000000000000000000000000x0000000000000000000000000000000000000000
Base0xdef1c0ded9bec7f1a1670819833240f027b25eff0x00000000000000000000000000000000000000000x0000000000000000000000000000000000000000

Errors​

See Error codes for a full list of common 0x error codes and how to resolve them.

Common Objects​

This section outlines API JSON objects that are common to many endpoints.

Misc.​

  • All requests and responses should be of "application/json" content type.
  • All token amounts are sent in amounts of the smallest level of precision (base units). (e.g if a token has 18 decimal places, selling 1 unit of the token would show up as selling 1000000000000000000 base units by this API).
  • All addresses are sent as lower-case (non-checksummed) Ethereum addresses with the 0x prefix.
  • All parameters should use lowerCamelCase.