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.