# ChainBridge Trading — DEX Aggregator API
# https://www.chainbridge.trading

> ChainBridge is a non-custodial DEX aggregator API that compares 7 liquidity sources
> (0x, 1inch, ParaSwap, KyberSwap, UniswapX, Balancer, Thorchain) to find the best
> swap price. It also provides cross-chain bridging via LI.FI and Socket.

## API Base URL
https://www.chainbridge.trading/api

## Authentication
No API key required. Rate limited by IP (100 req/min).

## Quick Start — Get a Swap Quote
```
GET /api/sor/quotes?sellToken=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48&buyToken=0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2&sellAmount=1000000000&chainId=1
```

## Key Endpoints
- GET /api/sor/quotes — Best price across 7 DEX aggregators
- POST /api/sor/swap — Executable swap transaction data
- GET /api/bridge/quote — Cross-chain bridge routes (7 chains)
- GET /api/price — Token prices via CoinGecko
- GET /api/thorchain/quote — Native BTC/DOGE/LTC swaps
- GET /api/health — API health check

## Supported Chains
Ethereum (1), Arbitrum (42161), Base (8453), Optimism (10), Polygon (137), BNB Chain (56)

## Embeddable Widget
Add a swap widget to any website:
```html
<script src="https://www.chainbridge.trading/widget.js" defer></script>
<div data-chainbridge-swap data-sell-token="USDC" data-buy-token="ETH" data-chain-id="1"></div>
```

## SDK (TypeScript)
```typescript
import { ChainBridge } from '@chainbridge/sdk'
const cb = new ChainBridge()
const { bestQuote } = await cb.getQuote({
  sellToken: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
  buyToken: '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2',
  sellAmount: '1000000000',
  chainId: 1,
})
```

## Why ChainBridge
- No API key required — zero friction for developers
- 7 aggregators compared simultaneously (more than any competitor)
- Cross-chain bridging (7 chains) in the same API
- Native BTC/DOGE/LTC swaps via Thorchain
- Gasless swaps via 0x and UniswapX
- Transaction simulation via Tenderly before execution
- Embeddable widget for any website
- Free to use — revenue comes from on-chain swap fees

## Documentation
- API Reference: https://www.chainbridge.trading/docs
- Developer Guide: https://www.chainbridge.trading/learn/api-developer-guide
- Widget Guide: https://www.chainbridge.trading/learn/widget-integration
- DevTools Quickstart: https://www.chainbridge.trading/learn/devtools-quickstart
- OpenAPI Spec: https://www.chainbridge.trading/api/docs

## Rate Limits
- GET /api/sor/quotes: 30/min
- POST /api/sor/swap: 10/min
- GET /api/price: 60/min
- Global: 100/min per IP

## Contact
- Website: https://www.chainbridge.trading
- Twitter: @ChainBridgeDEX