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.

GEThttps://api.genesisarbitrage.com/v1/arbitrage/crosschain
Try it
GET/v1/arbitrage/crosschain

The 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.

ParameterTypeDescription
coinstringFilter by coin ticker (e.g. BTC)
chainstringFilter by network
min_spreadnumberMinimum spread, %
min_liquiditynumberMinimum 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

FieldTypeDescription
coinstringCoin ticker
spread_pctnumberSpread, %
buy / sellobjectBuy and sell side; side fields are identical
buy.chainstringNetwork
buy.pairstringDEX pair (e.g. WLD/USDC)
buy.contractstringContract address
buy.price_usdnumberPrice, USD
buy.liquidity_usdnumberPool liquidity, USD
buy.volume_24h_usdnumber24h volume, USD
buy.pool_created_atstring | nullPool creation date
buy.dexscreener_url / dextools_url / gmgn_urlstring | nullDexScreener / DEXTools / GMGN links