API Documentation

No API Key Required

Start making requests immediately. No signup, no key management.

3 DEX Aggregators

Compare 0x, KyberSwap and ParaSwap in one call on Ethereum, Arbitrum, Base, Optimism, Polygon, BNB Chain, Avalanche and Linea.

Cross-chain Swaps

EVM to EVM via Relay and LI.FI; EVM to native BTC, LTC, DOGE and BCH via THORChain. Native to EVM is quote only.

Bridge Quote API

Cross-chain routes via LI.FI and Socket (API only).

Gasless Swaps

No gas needed for users on supported pairs via 0x Gasless (all networks except Linea).

Token Safety

GoPlus checks for honeypots, sell taxes and risky token permissions via /api/token-safety.

Transaction Simulation

Simulate the exact transaction via Tenderly before signing (when configured).

https:"color:#5c6370">//www.chainbridge.trading/api

{
  "error": "Description of what went wrong",
  "code": "ERROR_CODE",
  "status": 400
}

Fetches quotes from all available DEX aggregators for a given token pair and amount. Returns quotes sorted by best output, including gas estimates and price impact.

Query Parameters

curl "https://www.chainbridge.trading/api/sor/quotes?\
  sellToken=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48&\
  buyToken=0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2&\
  sellAmount=1000000000&\
  chainId=1&\
  takerAddress=0xYourWallet"

Generates executable swap quotes. Returns the same envelope as /sor/quotes; the calldata to sign lives in bestQuote.to / bestQuote.data / bestQuote.value / bestQuote.gas.

Request Body

{
  "chainId": 1,
  "preferredAggregator": "0x",
  "sellToken": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
  "buyToken": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
  "sellAmount": "1000000000",
  "takerAddress": "0x...",
  "slippageBps": 100
}

curl -X POST "https://www.chainbridge.trading/api/sor/swap" \
  -H "Content-Type: application/json" \
  -d '{
    "chainId": 1,
    "preferredAggregator": "0x",
    "sellToken": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "buyToken": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
    "sellAmount": "1000000000",
    "takerAddress": "0xYourWallet",
    "slippageBps": 100
  }'

Returns the DEX aggregators, whether each is enabled, their supported chains, and features (gasless swaps, fee support).

Quotes every provider in parallel and ranks them by net amount received. Each quote carries the steps to sign (approval included when needed), executable: false for quote-only routes, and any ChainBridge fee as platformFeeBps.

Query Parameters

Normalized delivery status of a cross-chain transfer. Params: provider (relay, lifi, thorchain), srcTxHash, fromChainId, plus requestId for Relay and toChain or toChainId for THORChain.

Fetches cross-chain bridge quotes from all providers. Compares routes by output amount, estimated time, and fees.

Query Parameters

curl "https://www.chainbridge.trading/api/bridge/quote?\
  fromChainId=1&\
  toChainId=42161&\
  fromToken=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48&\
  toToken=0xaf88d065e77c8cC2239327C5EDb3A432268e5831&\
  fromAmount=1000000000&\
  fromAddress=0xYourWallet"

Generates transaction data for a route returned by GET /bridge/quote. Pass the full route object from the quote response; the calldata is returned in data.transaction.

curl -X POST "https://www.chainbridge.trading/api/bridge/transaction" \
  -H "Content-Type: application/json" \
  -d '{
    "route": {
      "id": "lifi-route-1",
      "provider": "lifi",
      "bridgeUsed": "stargate",
      "fromChainId": 1,
      "toChainId": 42161
    },
    "fromAddress": "0xYourWallet",
    "slippageBps": 100
  }'

Checks bridge transaction status. Returns state (pending, in transit, completed, failed), estimated time, and tx hashes on both chains.

curl "https://www.chainbridge.trading/api/bridge/status?\
  provider=lifi&\
  txHash=0xabc123...def456&\
  fromChainId=1"

Returns supported chains for bridging with metadata (name, chain ID, native token, explorer URL) and available providers per route.

Returns current USD prices for specified tokens. Supports multiple addresses in a single request.

Query Parameters

curl "https://www.chainbridge.trading/api/price?\
  chainId=1&\
  tokens=0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2,0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"

"color:#5c6370"># Get a swap quote(no setup needed)
curl "https://www.chainbridge.trading/api/sor/quotes?sellToken=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48&buyToken=0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2&sellAmount=1000000000&chainId=1"

"color:#5c6370"># Get bridge quote
curl "https://www.chainbridge.trading/api/bridge/quote?fromChainId=1&toChainId=42161&fromToken=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48&toToken=0xaf88d065e77c8cC2239327C5EDb3A432268e5831&fromAmount=1000000000&fromAddress=0xYourWallet"

"color:#5c6370"># Get token price(USD, keyed by lowercased address)
curl "https://www.chainbridge.trading/api/price?chainId=1&tokens=0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"