Genesis API Documentation

Everything you need to integrate: authentication, limits, endpoints and response schemas.

DocumentationFunding spread

Funding spread

TrialStartProMax

The best exchange pair by funding spread for every coin, plus the rest of the exchanges.

GEThttps://api.genesisarbitrage.com/v1/funding/spread
Try it
GET/v1/funding/spread

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)
min_spreadnumberMinimum spread, %

Example request

bash
curl "https://api.genesisarbitrage.com/v1/funding/spread" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

Example response

One element of the data array is shown (real data):

json
{
  "coin": "BTC",
  "spread_pct": 0.01,
  "best": {
    "exchange_1": "Hyper",
    "exchange_2": "CoinEx",
    "funding_1_pct": 0.0,
    "funding_2_pct": 0.0,
    "next_payout_1": null,
    "next_payout_2": "08:00",
    "interval_1": "1h",
    "interval_2": "8h",
    "trade_url_1": "https://app.hyperliquid.xyz/trade/BTC",
    "trade_url_2": "https://www.coinex.com/futures/BTC-usdt"
  },
  "others": [
    {
      "exchange": "Bitget",
      "funding_pct": 0.0,
      "next_payout": "00:00",
      "interval": "8h",
      "trade_url": "https://www.bitget.com/futures/usdt/BTCUSDT"
    }
  ]
}

Response fields

FieldTypeDescription
coinstringCoin ticker
spread_pctnumberFunding spread of the best pair, %
best.exchange_1 / exchange_2stringExchanges of the best pair
best.funding_1_pct / funding_2_pctnumberFunding rate per interval, %
best.next_payout_1 / next_payout_2string | nullNext payout time (HH:MM UTC, null — no data)
best.interval_1 / interval_2string | nullFunding interval (e.g. 8h)
best.trade_url_1 / trade_url_2stringTrading terminal link
others[]arrayOther exchanges: exchange, funding_pct, next_payout, interval, trade_url