Genesis API Documentation
Everything you need to integrate: authentication, limits, endpoints and response schemas.
DocumentationCross-chain
Cross-chain
TrialStartProMax
One token across networks: price, liquidity and volume for each side, pool age and tool links.
GET
https://api.genesisarbitrage.com/v1/arbitrage/crosschainTry it
GET
/v1/arbitrage/crosschainThe key is stored only in your browser and is sent nowhere except the API.
Paste your key and send a request — we'll show a truncated response.
Query parameters
All parameters are optional: without filters the endpoint returns the full dataset.
| Parameter | Type | Description |
|---|---|---|
coin | string | Filter by coin ticker (e.g. BTC) |
chain | string | Filter by network |
min_spread | number | Minimum spread, % |
min_liquidity | number | Minimum liquidity, USD |
Example request
bash
curl "https://api.genesisarbitrage.com/v1/arbitrage/crosschain" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Example response
One element of the data array is shown (real data):
json
{
"coin": "WLD",
"spread_pct": 0.59,
"buy": {
"chain": "optimism",
"pair": "WLD/USDC",
"contract": "0xdC6fF44d5d932Cbd77B52E5612Ba0529DC6226F1",
"price_usd": 0.4048,
"liquidity_usd": 48747,
"volume_24h_usd": 2484,
"pool_created_at": "2023-07-24 08:44:19 UTC",
"dexscreener_url": "https://dexscreener.com/optimism/0xd1f1…",
"dextools_url": "https://www.dextools.io/app/optimism/pair-explorer/0xD1F1…",
"gmgn_url": null
},
"sell": {
"chain": "ethereum",
"pair": "WLD/WETH",
"contract": "0x163f8C2467924be0ae7B5347228CABF260318753",
"price_usd": 0.4072,
"liquidity_usd": 421426,
"volume_24h_usd": 34508,
"pool_created_at": "2023-07-24 07:41:59 UTC",
"dexscreener_url": "https://dexscreener.com/ethereum/0x8418…",
"dextools_url": "https://www.dextools.io/app/ether/pair-explorer/0x8418…",
"gmgn_url": "https://gmgn.ai/eth/token/0x163f…"
}
}Response fields
| Field | Type | Description |
|---|---|---|
coin | string | Coin ticker |
spread_pct | number | Spread, % |
buy / sell | object | Buy and sell side; side fields are identical |
buy.chain | string | Network |
buy.pair | string | DEX pair (e.g. WLD/USDC) |
buy.contract | string | Contract address |
buy.price_usd | number | Price, USD |
buy.liquidity_usd | number | Pool liquidity, USD |
buy.volume_24h_usd | number | 24h volume, USD |
buy.pool_created_at | string | null | Pool creation date |
buy.dexscreener_url / dextools_url / gmgn_url | string | null | DexScreener / DEXTools / GMGN links |