Skip to content

Arbitrage

Endpoint Overview

Method Endpoint Description
GET /v1/arbitrage/tickerlist Retrieves arbitrage ticker info meeting volume and market cap criteria.

Retrieve Arbitrage Ticker List

GET /v1/arbitrage/tickerlist

Purpose: Retrieves a list of potential arbitrage opportunities across multiple exchanges for specific token pairs.
Plan Requirement: Mega (available to Mega plan users only).

Request Query Parameters:

Name Type Mandatory
minVolumeUSD number No
minMarketCapUSD number No

Example Requests

GET /v1/arbitrage/tickerlist?minVolumeUSD=100000&minMarketCapUSD=5000000

Example Response

{
  "data": [
    {
      "baseSymbol": "CULT",
      "targetSymbol": "USDT",
      "baseTokenId": 34574,
      "targetTokenId": 825,
      "bestAsk": 0.000874,
      "bestAskExchange": "BITMART",
      "bestBid": 0.000904,
      "bestBidExchange": "KUCOIN",
      "spread": -0.00003,
      "aribtragePercentage": 3.4324
    },
    {
      "baseSymbol": "POLK",
      "targetSymbol": "USDT",
      "baseTokenId": 8579,
      "targetTokenId": 825,
      "bestAsk": 0.0086,
      "bestAskExchange": "BITMART",
      "bestBid": 0.00889,
      "bestBidExchange": "KUCOIN",
      "spread": -0.00029,
      "aribtragePercentage": 3.372
    },
    {
      "baseSymbol": "LIF3",
      "targetSymbol": "USDT",
      "baseTokenId": 20611,
      "targetTokenId": 825,
      "bestAsk": 0.003708,
      "bestAskExchange": "BTSE",
      "bestBid": 0.0037953,
      "bestBidExchange": "BITMART",
      "spread": -0.0000873,
      "aribtragePercentage": 2.3543
    }
    // Additional results omitted for brevity
  ],
  "success": true,
  "timestamp": 1741501294583,
  "requestId": "some-unique-request-id",
  "message": "",
  "error": null
}

Response Fields:

Name Description
baseSymbol Base token’s symbol (e.g., "CULT").
targetSymbol Quote token’s symbol (e.g., "USDT").
baseTokenId Unique AIO ID for the base token.
targetTokenId Unique AIO ID for the quote token.
bestAsk Lowest ask price across exchanges.
bestAskExchange Exchange with lowest ask price.
bestBid Highest bid price across exchanges.
bestBidExchange Exchange with highest bid price.
spread bestAsk - bestBid (negative indicates potential arbitrage).
aribtragePercentage Percentage difference between bestBid and bestAsk.

Usage & Best Practices:

  • Mega Plan Required: Available exclusively to Mega subscribers.
  • Combine Endpoints: Verify with Orderbook and TradeQuote endpoints for liquidity and fees.
  • Filtering: Use parameters to exclude low-volume or low-cap tokens.
  • Real-Time Changes: Opportunities update frequently; always confirm via orderbook before trades.