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.
GET
https://api.genesisarbitrage.com/v1/funding/spreadTry it
GET
/v1/funding/spreadThe 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) |
min_spread | number | Minimum 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
| Field | Type | Description |
|---|---|---|
coin | string | Coin ticker |
spread_pct | number | Funding spread of the best pair, % |
best.exchange_1 / exchange_2 | string | Exchanges of the best pair |
best.funding_1_pct / funding_2_pct | number | Funding rate per interval, % |
best.next_payout_1 / next_payout_2 | string | null | Next payout time (HH:MM UTC, null — no data) |
best.interval_1 / interval_2 | string | null | Funding interval (e.g. 8h) |
best.trade_url_1 / trade_url_2 | string | Trading terminal link |
others[] | array | Other exchanges: exchange, funding_pct, next_payout, interval, trade_url |