API Documentation

Access arbitrage opportunities programmatically. Premium subscription required.

Authentication

All API requests require authentication via Bearer token. Include your token in the Authorization header.

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://arb-scanner.pages.dev/api/v1/opportunities

Endpoints

GET /api/v1/opportunities

Returns current arbitrage opportunities across all tracked exchanges.

Query Parameters

Parameter	Type	Description
symbol	string	Filter by trading pair (e.g., BTC/USDT)
min_profit	number	Minimum net profit % (default: 0)
limit	number	Max results (default: 50, max: 100)

Response

{
  "opportunities": [
    {
      "symbol": "BTC/USDT",
      "buyExchange": "Binance",
      "sellExchange": "Kraken",
      "buyPrice": 67450.00,
      "sellPrice": 67650.00,
      "spreadPercent": 0.30,
      "netProfitPercent": 0.12,
      "totalFees": 121.98
    }
  ],
  "timestamp": "2026-01-24T10:30:00Z",
  "count": 15
}

GET /api/v1/prices

Returns current prices across all exchanges for a symbol.

Query Parameters

Parameter	Type	Description
symbol	string	Trading pair (required, e.g., ETH/USDT)

Response

{
  "symbol": "ETH/USDT",
  "prices": [
    { "exchange": "Binance", "price": 3455.20, "timestamp": "2026-01-24T10:30:00Z" },
    { "exchange": "Coinbase", "price": 3458.50, "timestamp": "2026-01-24T10:30:00Z" },
    { "exchange": "Kraken", "price": 3462.00, "timestamp": "2026-01-24T10:30:00Z" }
  ]
}

GET /api/v1/exchanges

Returns list of supported exchanges with their fee rates.

Response

{
  "exchanges": [
    { "name": "Binance", "feeRate": 0.001, "status": "online" },
    { "name": "Coinbase", "feeRate": 0.006, "status": "online" },
    { "name": "Kraken", "feeRate": 0.0026, "status": "online" },
    { "name": "Bybit", "feeRate": 0.001, "status": "online" },
    { "name": "OKX", "feeRate": 0.001, "status": "online" }
  ]
}

Rate Limits

Plan	Requests/min	Requests/day
Premium	60	10,000

Rate limit headers are included in every response: X-RateLimit-Remaining, X-RateLimit-Reset

Ready to Integrate?

Get Premium access to start using the API today.

Get API Access