# Genesis API — full reference > Crypto market data REST API: CEX and DEX arbitrage spreads, order books, funding rates, open interest, on-chain flows, prediction markets and sportsbook surebets. One API key, one JSON format, HTTPS GET. Plans from $20 a month. Genesis API is REST access to Genesis Arbitrage data: CEX and DEX spreads, order books and execution prices, funding, cross-chain, on-chain flows, prediction markets and AI signals. The core refreshes data every second, and responses come in one JSON format. Every request is a plain HTTP GET. No SDK required — any language with an HTTP client will do. Genesis Arbitrage (https://genesisarbitrage.com) is a crypto arbitrage scanner for centralized and decentralized exchanges, prediction markets and sportsbooks; the API serves the same data its pages show. Machine-readable files: - OpenAPI 3.1 specification: https://genesisarbitrage.com/openapi.json - API catalog (RFC 9727): https://genesisarbitrage.com/.well-known/api-catalog - Site overview for LLMs: https://genesisarbitrage.com/llms.txt Human pages: - Documentation: https://genesisarbitrage.com/en/api/docs (every section has its own page: https://genesisarbitrage.com/en/api/docs/
) - Pricing: https://genesisarbitrage.com/en/api/pricing - Product page: https://genesisarbitrage.com/en/api/description - Quick start guide: https://genesisarbitrage.com/en/guide/api/quick-start ## Basics - Base URL: `https://api.genesisarbitrage.com/v1` - Authentication: Every request must carry the X-API-Key header with your gns_live_… key. Keys are created and revoked in your dashboard. The key is shown only once at creation. We store only its hash — a lost key cannot be recovered, only reissued. Never pass the key in query parameters or embed it in client-side code. Make requests from your server only. - Empty values are null. Spreads and rates are percentages: 0.92 means 0.92%. Timestamps are unix seconds. - Every response carries an X-Request-Id header. When contacting support, send it with the request time in UTC, the endpoint and the status — never your key. ### Plans and limits | Plan | Price | Calls per month | Requests per second | Data freshness | |---|---|---|---|---| | Trial | $20/mo | 500K | 1 | 60 s | | Start | $50/mo | 2M | 2 | 30 s | | Pro | $100/mo | 5M | 5 | 10 s | | Max | $200/mo | 10M | 15 | 5 s | Data freshness depends on your plan: 60 s on Trial, 30 s on Start, 10 s on Pro and 5 s on Max. Paying for 3 months saves 10%, for 6 months 20%. - Limits are set by your plan. The current state is always available at /account/usage and in the headers of every response. - Endpoints outside your plan return 403 with the plan_restricted code. Requests over the limits are never billed. - Only a 200 response counts as a call. 304 (not modified) responses and 4xx/5xx errors do not use your quota, but they still count toward the requests-per-second limit. - Download volume is limited to 60 MB of compressed data per 10 seconds per key. Polling every dataset at your plan's freshness fits with room to spare; responses under 64 KB are not counted. Over the limit — 429 download_limited until the window ends, not counted. Save traffic with If-None-Match, filters and the coin parameter. Rate-limit headers: | Header | Meaning | |---|---| | X-RateLimit-Limit | Requests-per-second limit for your plan | | X-RateLimit-Remaining | Requests left in the current window | | X-RateLimit-Reset | Unix time when the window resets | | X-Quota-Limit | Call quota for the current 30-day period | | X-Quota-Remaining | Calls left in the period | | X-Quota-Reset | Unix time the quota resets | | Retry-After | Seconds to wait before retrying (on 429 and 503) | ### Response envelope All successful responses share the same structure: ```json { "success": true, "data": [ … ], "meta": { "count": 214, "updated_at": 1783802410, "freshness_sec": 10, "plan": "pro" } } ``` ### Errors Errors return the matching HTTP status with a body: ```json { "success": false, "error": { "code": "rate_limited", "message": "Requests per second limit exceeded." } } ``` | HTTP | Code | Meaning | |---|---|---| | 400 | bad_request | Invalid request parameters — details in message | | 401 | invalid_key | Key missing, invalid or revoked, or the API plan has expired | | 403 | plan_restricted | Endpoint is not included in your plan | | 404 | not_found | Endpoint or resource not found | | 410 | gone | The endpoint is retired — the replacement is in message | | 429 | rate_limited | Rate limit exceeded — see X-RateLimit and Retry-After | | 429 | download_limited | Download volume exceeded: 60 MB of compressed data per 10 seconds per key — see Retry-After | | 500 | internal_error | Internal error, retry later | | 503 | snapshot_not_ready | Data is being rebuilt or its source is restarting — retry in a few seconds, see Retry-After | ### Quick start ```bash curl "https://api.genesisarbitrage.com/v1/arbitrage/spot-spot?min_spread=0.5" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" ``` ```python import requests r = requests.get( "https://api.genesisarbitrage.com/v1/arbitrage/spot-spot", headers={"X-API-Key": "gns_live_XXXXXXXXXXXXXXXX"}, params={"min_spread": 0.5}, ) for row in r.json()["data"]: print(row["coin"], row["exchange_buy"], "→", row["exchange_sell"], f"{row['spread_pct']}%") ``` ```javascript const res = await fetch( 'https://api.genesisarbitrage.com/v1/arbitrage/spot-spot?min_spread=0.5', { headers: { 'X-API-Key': 'gns_live_XXXXXXXXXXXXXXXX' } } ); const { data } = await res.json(); for (const row of data) { console.log(row.coin, row.exchange_buy, '→', row.exchange_sell, row.spread_pct + '%'); } ``` ## Endpoints | Endpoint | What it returns | Plans | |---|---|---| | GET /arbitrage/spot-spot | Spot — Spot | Trial, Start, Pro, Max | | GET /arbitrage/spot-futures | Spot — Futures | Trial, Start, Pro, Max | | GET /arbitrage/futures-futures | Futures — Futures | Trial, Start, Pro, Max | | GET /arbitrage/dex-spot | DEX — Spot | Pro, Max | | GET /arbitrage/dex-futures | DEX — Futures | Pro, Max | | GET /arbitrage/crosschain | Cross-chain | Pro, Max | | GET /arbitrage/stocks | Stock Arbitrage | Start, Pro, Max | | GET /orderbooks/exec | Execution prices | Pro, Max | | GET /orderbooks/spreads/{dataset} | Order-book Δ | Pro, Max | | GET /orderbooks/book | Market order book | Pro, Max | | GET /orderbooks/coin/{coin} | Coin order books | Pro, Max | | GET /orderbooks/exec-history | Execution history | Pro, Max | | GET /orderbooks/dex-slippage | DEX slippage | Pro, Max | | GET /predictions/arbitrage | Prediction Arbitrage | Start, Pro, Max | | GET /predictions/platforms | Platform status | Start, Pro, Max | | GET /predictions/analytics | Market analytics | Pro, Max | | GET /predictions/smart-money | Smart money | Pro, Max | | GET /predictions/trades | Large trades | Pro, Max | | GET /predictions/traders | Trader leaderboard | Pro, Max | | GET /funding/rates | Funding rates | Trial, Start, Pro, Max | | GET /funding/spread | Funding spread | Trial, Start, Pro, Max | | GET /funding/analytics/summary | Analytics: summary | Pro, Max | | GET /funding/analytics/recent | Analytics: payouts 7d | Pro, Max | | GET /funding/analytics/daily | Analytics: days 1y | Pro, Max | | GET /funding/analytics/top | Analytics: screener | Pro, Max | | GET /market/fair-price | Fair - Last | Trial, Start, Pro, Max | | GET /market/pumps | CEX Pumps - Dumps | Trial, Start, Pro, Max | | GET /market/dex-dumps | DEX Dumps | Pro, Max | | GET /market/open-interest | OI Tracking | Trial, Start, Pro, Max | | GET /onchain/{section} | Genesis Onchain | Start, Pro, Max | | GET /onchain/dex-swaps | DEX overview | Pro, Max | | GET /onchain/analytics | OnChain analytics | Pro, Max | | GET /onchain/coin/{symbol} | OnChain coin | Pro, Max | | GET /ai/signals | AI Signals | Trial, Start, Pro, Max | | GET /coins/search | Coin Search | Trial, Start, Pro, Max | | GET /account/usage | Usage | Trial, Start, Pro, Max | ## Arbitrage Arbitrage spreads between CEX spot and futures markets, DEX and CEX, networks (cross-chain) and tokenized stocks. ### Spot — Spot — `GET /arbitrage/spot-spot` Plans: Trial, Start, Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/spot-spot Spreads between CEX spot markets. For every coin — buy/sell setups with prices, order book, deposit/withdrawal status and trading links. Query parameters: | Parameter | Type | Description | |---|---|---| | `coin` | string | Filter by coin ticker (e.g. BTC) | | `exchange` | string | Filter by exchange; comma-separated for several | | `min_spread` | number | Minimum spread, % | | `min_volume` | number | Minimum 24h volume on both sides, USD | Example request: ```bash curl "https://api.genesisarbitrage.com/v1/arbitrage/spot-spot" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" ``` Example response (one data entry): ```json { "coin": "FUEL", "exchange_buy": "ByBit", "exchange_sell": "Gate", "market_buy": "spot", "market_sell": "spot", "price_buy": 0.0007029, "price_sell": 0.0007037, "bid_buy": 0.0007027, "ask_buy": 0.0007029, "bid_sell": 0.0007021, "ask_sell": 0.0007037, "spread_pct": 0.11, "network": "ETH", "contract": "0x675B68AA4d9c2d3BB3F0397048e62E6B7192079c", "deposit_enabled_buy": true, "withdraw_enabled_buy": true, "deposit_enabled_sell": true, "withdraw_enabled_sell": true, "volume_24h_buy": 17652.64, "volume_24h_sell": 12512.51, "trade_url_buy": "https://www.bybit.com/trade/spot/FUEL/USDT", "trade_url_sell": "https://www.gate.io/trade/FUEL_USDT" } ``` Response fields: | Field | Type | Description | |---|---|---| | `coin` | string | Coin ticker | | `exchange_buy / exchange_sell` | string | Buy / sell exchange | | `market_buy / market_sell` | string | Market type: spot or futures | | `price_buy / price_sell` | number | Price on the buy / sell exchange | | `bid_* / ask_*` | number \| null | Best bid and ask on each side | | `spread_pct` | number | Spread, % | | `network` | string | Token network | | `contract` | string \| null | Contract address | | `deposit_enabled_* / withdraw_enabled_*` | boolean | Whether deposits and withdrawals are open | | `volume_24h_buy / volume_24h_sell` | number \| null | 24h volume, USD | | `trade_url_buy / trade_url_sell` | string | Trading terminal link | ### Spot — Futures — `GET /arbitrage/spot-futures` Plans: Trial, Start, Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/spot-futures Divergence between spot and futures on CEX exchanges. Same response format as Spot — Spot, only the market type differs. Query parameters: | Parameter | Type | Description | |---|---|---| | `coin` | string | Filter by coin ticker (e.g. BTC) | | `exchange` | string | Filter by exchange; comma-separated for several | | `min_spread` | number | Minimum spread, % | | `min_volume` | number | Minimum 24h volume on both sides, USD | Example request: ```bash curl "https://api.genesisarbitrage.com/v1/arbitrage/spot-futures" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" ``` Example response (one data entry): ```json { "coin": "FUEL", "exchange_buy": "ByBit", "exchange_sell": "Gate", "market_buy": "spot", "market_sell": "futures", "price_buy": 0.0007029, "price_sell": 0.0007037, "bid_buy": 0.0007027, "ask_buy": 0.0007029, "bid_sell": 0.0007021, "ask_sell": 0.0007037, "spread_pct": 0.11, "network": "ETH", "contract": "0x675B68AA4d9c2d3BB3F0397048e62E6B7192079c", "deposit_enabled_buy": true, "withdraw_enabled_buy": true, "deposit_enabled_sell": true, "withdraw_enabled_sell": true, "volume_24h_buy": 17652.64, "volume_24h_sell": 12512.51, "trade_url_buy": "https://www.bybit.com/trade/spot/FUEL/USDT", "trade_url_sell": "https://www.gate.io/trade/FUEL_USDT" } ``` Response fields: | Field | Type | Description | |---|---|---| | `coin` | string | Coin ticker | | `exchange_buy / exchange_sell` | string | Buy / sell exchange | | `market_buy / market_sell` | string | Market type: spot or futures | | `price_buy / price_sell` | number | Price on the buy / sell exchange | | `bid_* / ask_*` | number \| null | Best bid and ask on each side | | `spread_pct` | number | Spread, % | | `network` | string | Token network | | `contract` | string \| null | Contract address | | `deposit_enabled_* / withdraw_enabled_*` | boolean | Whether deposits and withdrawals are open | | `volume_24h_buy / volume_24h_sell` | number \| null | 24h volume, USD | | `trade_url_buy / trade_url_sell` | string | Trading terminal link | ### Futures — Futures — `GET /arbitrage/futures-futures` Plans: Trial, Start, Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/futures-futures Spreads between futures markets of different CEX exchanges. Same response format as Spot — Spot. Query parameters: | Parameter | Type | Description | |---|---|---| | `coin` | string | Filter by coin ticker (e.g. BTC) | | `exchange` | string | Filter by exchange; comma-separated for several | | `min_spread` | number | Minimum spread, % | | `min_volume` | number | Minimum 24h volume on both sides, USD | Example request: ```bash curl "https://api.genesisarbitrage.com/v1/arbitrage/futures-futures" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" ``` Example response (one data entry): ```json { "coin": "FUEL", "exchange_buy": "ByBit", "exchange_sell": "Gate", "market_buy": "futures", "market_sell": "futures", "price_buy": 0.0007029, "price_sell": 0.0007037, "bid_buy": 0.0007027, "ask_buy": 0.0007029, "bid_sell": 0.0007021, "ask_sell": 0.0007037, "spread_pct": 0.11, "network": "ETH", "contract": "0x675B68AA4d9c2d3BB3F0397048e62E6B7192079c", "deposit_enabled_buy": true, "withdraw_enabled_buy": true, "deposit_enabled_sell": true, "withdraw_enabled_sell": true, "volume_24h_buy": 17652.64, "volume_24h_sell": 12512.51, "trade_url_buy": "https://www.bybit.com/trade/spot/FUEL/USDT", "trade_url_sell": "https://www.gate.io/trade/FUEL_USDT" } ``` Response fields: | Field | Type | Description | |---|---|---| | `coin` | string | Coin ticker | | `exchange_buy / exchange_sell` | string | Buy / sell exchange | | `market_buy / market_sell` | string | Market type: spot or futures | | `price_buy / price_sell` | number | Price on the buy / sell exchange | | `bid_* / ask_*` | number \| null | Best bid and ask on each side | | `spread_pct` | number | Spread, % | | `network` | string | Token network | | `contract` | string \| null | Contract address | | `deposit_enabled_* / withdraw_enabled_*` | boolean | Whether deposits and withdrawals are open | | `volume_24h_buy / volume_24h_sell` | number \| null | 24h volume, USD | | `trade_url_buy / trade_url_sell` | string | Trading terminal link | ### DEX — Spot — `GET /arbitrage/dex-spot` Plans: Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/dex-spot Price gaps between DEX and CEX spot. Includes pool liquidity, market cap and ready links to DexScreener, DEXTools and GMGN. Query parameters: | Parameter | Type | Description | |---|---|---| | `coin` | string | Filter by coin ticker (e.g. BTC) | | `exchange` | string | Filter by exchange; comma-separated for several | | `min_spread` | number | Minimum spread, % | | `min_liquidity` | number | Minimum liquidity, USD | Example request: ```bash curl "https://api.genesisarbitrage.com/v1/arbitrage/dex-spot" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" ``` Example response (one data entry): ```json { "coin": "SCR", "exchange": "MEXC", "cex_price": 0.02691, "dex_price": 0.02679, "spread_pct": 0.45, "network": "SCROLL", "contract": "0xd29687c813D741E2F938F4aC377128810E217b1b", "liquidity_usd": 10544.15, "market_cap": 5091835.0, "dex_volume_24h": 319.73, "deposit_enabled": true, "withdraw_enabled": true, "trade_url": "https://www.mexc.com/exchange/SCR_USDT", "dexscreener_url": "https://dexscreener.com/scroll/0xd296…", "dextools_url": null, "gmgn_url": null } ``` Response fields: | Field | Type | Description | |---|---|---| | `coin` | string | Coin ticker | | `exchange` | string | Exchange | | `cex_price` | number | CEX price | | `dex_price` | number | DEX price | | `spread_pct` | number | Spread, % | | `network` | string | Token network | | `contract` | string | Contract address | | `liquidity_usd` | number | Pool liquidity, USD | | `market_cap` | number \| null | Market cap, USD | | `dex_volume_24h` | number \| null | 24h DEX volume, USD | | `deposit_enabled / withdraw_enabled` | boolean | Whether deposits and withdrawals are open | | `trade_url` | string | Trading terminal link | | `dexscreener_url / dextools_url / gmgn_url` | string \| null | DexScreener / DEXTools / GMGN links | ### DEX — Futures — `GET /arbitrage/dex-futures` Plans: Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/dex-futures Spreads between DEX and CEX futures. Also carries the maximum position size where the exchange provides it. Query parameters: | Parameter | Type | Description | |---|---|---| | `coin` | string | Filter by coin ticker (e.g. BTC) | | `exchange` | string | Filter by exchange; comma-separated for several | | `min_spread` | number | Minimum spread, % | | `min_liquidity` | number | Minimum liquidity, USD | Example request: ```bash curl "https://api.genesisarbitrage.com/v1/arbitrage/dex-futures" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" ``` Example response (one data entry): ```json { "exchange": "lighter", "ticker": "2ZUSDT", "coin": "2Z", "cex_price": 0.07175, "dex_price": 0.071685, "spread_pct": 0.09, "network": "Solana(SOL)", "contract": "J6pQQ3FAcJQeWPPGppWRb4nM8jU3wLyYbRrLh7feMfvd", "liquidity_usd": 670124.94, "max_position_usd": null, "deposit_enabled": true, "withdraw_enabled": true, "trade_url": "https://app.lighter.xyz/trade/2Z", "dexscreener_url": "https://dexscreener.com/solana/J6pQ…", "dextools_url": "https://dextools.io/app/en/solana/pair-explorer/J6pQ…", "gmgn_url": "https://gmgn.ai/sol/token/J6pQ…" } ``` Response fields: | Field | Type | Description | |---|---|---| | `exchange` | string | Exchange | | `ticker` | string | Exchange pair (e.g. TONUSDT) | | `coin` | string | Coin ticker | | `cex_price` | number | CEX price | | `dex_price` | number | DEX price | | `spread_pct` | number | Spread, % | | `network` | string | Token network | | `contract` | string | Contract address | | `liquidity_usd` | number | Pool liquidity, USD | | `max_position_usd` | number \| null | Maximum position size, USD (null if not provided) | | `deposit_enabled / withdraw_enabled` | boolean | Whether deposits and withdrawals are open | | `trade_url` | string | Trading terminal link | | `dexscreener_url / dextools_url / gmgn_url` | string \| null | DexScreener / DEXTools / GMGN links | ### Cross-chain — `GET /arbitrage/crosschain` Plans: Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/crosschain One token across networks: price, liquidity and volume for each side, pool age and tool links. Query parameters: | 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 data entry): ```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 | ### Stock Arbitrage — `GET /arbitrage/stocks` Plans: Start, Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/stocks Spreads on tokenized stocks, metals, indices and commodities between CEX exchanges. The instrument ticker may differ per exchange. Query parameters: | Parameter | Type | Description | |---|---|---| | `symbol` | string | Filter by instrument ticker | | `category` | string | Filter by category | | `exchange` | string | Filter by exchange; comma-separated for several | | `min_spread` | number | Minimum spread, % | Example request: ```bash curl "https://api.genesisarbitrage.com/v1/arbitrage/stocks" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" ``` Example response (one data entry): ```json { "symbol": "BRENT", "category": "Commodity", "exchange_buy": "MEXC", "exchange_sell": "Ourbit", "symbol_on_buy": "UKOIL", "symbol_on_sell": "BRENTOIL", "price_buy": 76.68, "price_sell": 76.82, "bid_buy": 76.71, "ask_buy": 76.72, "bid_sell": 76.8, "ask_sell": 76.89, "spread_pct": 0.18, "trade_url_buy": "https://futures.mexc.com/exchange/UKOIL_USDT", "trade_url_sell": "https://futures.ourbit.com/exchange/BRENTOIL_USDT" } ``` Response fields: | Field | Type | Description | |---|---|---| | `symbol` | string | Instrument ticker | | `category` | string | Category: Stock, Metal, Index or Commodity | | `exchange_buy / exchange_sell` | string | Buy / sell exchange | | `symbol_on_buy / symbol_on_sell` | string | Instrument ticker on this exchange | | `price_buy / price_sell` | number | Price on the buy / sell exchange | | `bid_* / ask_*` | number \| null | Best bid and ask on each side | | `spread_pct` | number | Spread, % | | `trade_url_buy / trade_url_sell` | string | Trading terminal link | ## Order books Order books: execution prices for a USD volume on every market, executable spreads, a market’s book, slippage history and DEX slippage. ### Execution prices — `GET /orderbooks/exec` Plans: Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/ob-exec Market buy and sell price for a given volume on every market, from the order books — what the site's «Order-book Δ» is computed from. Volumes: $500, 1000, 2500, 5000 and 10,000; null — the book is too thin for this volume. Books lag the exchange by 5–20 seconds; each book's age is in /orderbooks/book. Query parameters: | Parameter | Type | Description | |---|---|---| | `volume` | number | Volume in USD: 500, 1000, 2500, 5000 or 10000 (required) | | `exchange` | string | Filter by exchange; comma-separated for several | | `market` | string | spot or futures | | `coin` | string | Filter by coin ticker (e.g. BTC) | Example request: ```bash curl "https://api.genesisarbitrage.com/v1/orderbooks/exec?volume=1000" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" ``` Example response (one data entry): ```json { "volume": 1000, "markets": { "Binance|spot|BTC": [96021.5, 96010.2], "ByBit|futures|BTC": [96030.1, 96018.7], "Ourbit|spot|SHELL": [0.10418, null] } } ``` Response fields: | Field | Type | Description | |---|---|---| | `volume` | number | Volume the execution is computed for, USD | | `markets{}` | object | Key Exchange\|market\|COIN → [buy price, sell price]; null — the book is too thin | ### Order-book Δ — `GET /orderbooks/spreads/{dataset}` Plans: Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/ob-spreads «Order-book Δ» for every row of one coin in the chosen arbitrage dataset — the same formulas as the site's column. CEX pairs: buy through the first exchange's asks, sell into the second one's bids, capped at the row's spread. DEX rows: the spread sign sets the direction (≥ 0 — sell into the CEX bids, < 0 — buy from the asks), a flipped sign gives 0. volume = 0 — at the best book prices. Query parameters: | Parameter | Type | Description | |---|---|---| | `{dataset}` | string | Dataset in the path: spot-spot, spot-futures, futures-futures, dex-spot or dex-futures | | `coin` | string | Coin ticker (required) | | `volume` | number | 0 (default) — best book prices, or 500, 1000, 2500, 5000, 10000 | Example request: ```bash curl "https://api.genesisarbitrage.com/v1/orderbooks/spreads/spot-futures?coin=BTC&volume=5000" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" ``` Example response (one data entry): ```json { "coin": "BTC", "exchange_buy": "Binance", "exchange_sell": "ByBit", "market_buy": "spot", "market_sell": "futures", "price_buy": 96016, "price_sell": 96046, "ask_buy": 96016, "bid_sell": 96045.8, "spread_pct": 0.031, "order_delta": { "volume": 5000, "buy_price": 96019.8, "sell_price": 96039.2, "spread_pct": 0.0202, "status": "ok" } } ``` Response fields: | Field | Type | Description | |---|---|---| | `…` | | All fields of the dataset's row — as in its endpoint | | `order_delta.volume` | number | Computation volume, USD (0 — best prices) | | `order_delta.buy_price / sell_price` | number \| null | CEX pair: buy and sell price for this volume | | `order_delta.side / cex_price` | string / number \| null | DEX row: the CEX side (sell or buy) and the execution price | | `order_delta.spread_pct` | number \| null | Spread after executing through the books, % | | `order_delta.status` | string | ok; no_book — no book; exhausted — the book did not fill | ### Market order book — `GET /orderbooks/book` Plans: Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/ob-book One market's order book, as in the site's «Order book» window: best prices, 10 levels per side in $, the largest walls, depth within ±50% and the book's age. depth_limited — the exchange publishes limited depth, so large volumes may not fill. Query parameters: | Parameter | Type | Description | |---|---|---| | `exchange` | string | Exchange (case-insensitive) | | `market` | string | spot or futures | | `coin` | string | Coin ticker (required) | Example request: ```bash curl "https://api.genesisarbitrage.com/v1/orderbooks/book?exchange=Binance&market=spot&coin=BTC" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" ``` Example response (one data entry): ```json { "exchange": "Binance", "market": "spot", "coin": "BTC", "book_ts": 1794675858, "age_sec": 6, "stale": false, "source": "ws", "depth_limited": false, "levels_bid": 500, "levels_ask": 500, "best_bid": 96015.9, "best_ask": 96016, "bids": [[96015.9, 412300.5], [96015.8, 51020.3], …], "asks": [[96016, 388120.2], [96016.1, 20410.7], …], "walls_bid": [[95900, 2410000]], "walls_ask": [[96500, 1980000]], "depth_bid_usd": 61234567, "depth_ask_usd": 58765432 } ``` Response fields: | Field | Type | Description | |---|---|---| | `exchange / market / coin` | string | Exchange, market and coin | | `book_ts / age_sec / stale` | int / int / boolean | Book time, its age in seconds and the stale flag (older than 30 s) | | `source / depth_limited` | string / boolean | Book source — ws or rest; depth_limited — limited depth | | `levels_bid / levels_ask` | int | Number of book levels per side | | `best_bid / best_ask` | number | Best bid and ask | | `bids / asks` | [number, number][] | Top 10 levels: [price, USD amount] | | `walls_bid / walls_ask` | [number, number][] | Largest walls: [price, USD amount] | | `depth_bid_usd / depth_ask_usd` | number | Total side depth within ±50% of the best price, USD | ### Coin order books — `GET /orderbooks/coin/{coin}` Plans: Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/ob-coin A coin's order books on every exchange and market at once — same fields as /orderbooks/book. Query parameters: | Parameter | Type | Description | |---|---|---| | `{coin}` | string | Coin ticker (required) | Example request: ```bash curl "https://api.genesisarbitrage.com/v1/orderbooks/coin/BTC" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" ``` Example response (one data entry): ```json { "exchange": "Binance", "market": "spot", "coin": "BTC", "book_ts": 1794675858, "age_sec": 6, "stale": false, "source": "ws", "depth_limited": false, "levels_bid": 500, "levels_ask": 500, "best_bid": 96015.9, "best_ask": 96016, "bids": [[96015.9, 412300.5], [96015.8, 51020.3], …], "asks": [[96016, 388120.2], [96016.1, 20410.7], …], "walls_bid": [[95900, 2410000]], "walls_ask": [[96500, 1980000]], "depth_bid_usd": 61234567, "depth_ask_usd": 58765432 } ``` Response fields: | Field | Type | Description | |---|---|---| | `exchange / market / coin` | string | Exchange, market and coin | | `book_ts / age_sec / stale` | int / int / boolean | Book time, its age in seconds and the stale flag (older than 30 s) | | `source / depth_limited` | string / boolean | Book source — ws or rest; depth_limited — limited depth | | `levels_bid / levels_ask` | int | Number of book levels per side | | `best_bid / best_ask` | number | Best bid and ask | | `bids / asks` | [number, number][] | Top 10 levels: [price, USD amount] | | `walls_bid / walls_ask` | [number, number][] | Largest walls: [price, USD amount] | | `depth_bid_usd / depth_ask_usd` | number | Total side depth within ±50% of the best price, USD | ### Execution history — `GET /orderbooks/exec-history` Plans: Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/ob-history Slippage history from Genesis Charts: for every market and volume, how many basis points from the book mid execution cost. 360 points per interval: 1m — 6 hours, 15m — 3.75 days, 1h — 15 days, 1d — about a year (data since 6 Sep 2026). Up to 8 markets per request; null — no data or the book did not fill. Query parameters: | Parameter | Type | Description | |---|---|---| | `keys` | string | Up to 8 market keys like Binance\|spot\|BTC, comma-separated | | `interval` | string | 1m, 15m, 1h or 1d (required) | Example request: ```bash curl "https://api.genesisarbitrage.com/v1/orderbooks/exec-history?keys=Binance|spot|BTC&interval=1h" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" ``` Example response (one data entry): ```json { "interval": "1h", "step_sec": 3600, "points": 360, "volumes_usd": [500, 1000, 2500, 5000, 10000], "last_bucket_ts": 1794672000, "series": { "Binance|spot|BTC": { "buy": [[1, 1, 2, …], [1, 2, 2, …], [2, 3, 4, …], [3, 4, 6, …], [5, 7, 9, …]], "sell": [[-1, -1, -2, …], …] }, "Unknown|spot|XYZ": null } } ``` Response fields: | Field | Type | Description | |---|---|---| | `interval / step_sec / points` | string / int / int | Interval, step in seconds and number of points | | `volumes_usd` | number[] | Volume grid, USD | | `last_bucket_ts` | int | Time of the last bucket; points run oldest to newest and end with it | | `series{}.buy / sell` | (int \| null)[5][360] | Per market key: buy and sell — 5 series (per volume) of 360 values in bps from the book mid; null — unknown key | ### DEX slippage — `GET /orderbooks/dex-slippage` Plans: Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/ob-dexslip DEX leg: buy and sell slippage for $100 to $100,000, token taxes and the honeypot flag per contract — the same as the site's DEX table columns. A null tax means no source, not 0%. Query parameters: | Parameter | Type | Description | |---|---|---| | `contract` | string | Contract address; several — comma-separated | | `network` | string | Network (as in the network field) | Example request: ```bash curl "https://api.genesisarbitrage.com/v1/orderbooks/dex-slippage" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" ``` Example response (one data entry): ```json { "sizes_usd": [100, 500, 1000, 2500, 5000, 10000, 20000, 50000, 100000], "contracts": [ { "contract": "0x6982508145454ce325ddbe47a25d4ec3d2311933", "network": "ETH", "tax_buy_pct": 0, "tax_sell_pct": 0, "honeypot": "no", "slippage_buy_pct": [0.31, 0.33, 0.36, 0.44, 0.58, 0.86, 1.41, 3.12, 6.05], "slippage_sell_pct": [0.31, 0.34, 0.37, 0.46, 0.61, 0.9, 1.5, 3.3, 6.4], "updated_at": 1794671040 } ] } ``` Response fields: | Field | Type | Description | |---|---|---| | `sizes_usd` | number[] | Slippage ladder volume grid, USD | | `contracts[].contract / network` | string | Contract and network | | `contracts[].tax_buy_pct / tax_sell_pct` | number \| null | Token buy and sell tax, % (null — no source) | | `contracts[].honeypot` | string | honeypot: no; suspect — sources disagree; yes — selling may be impossible | | `contracts[].slippage_buy_pct / slippage_sell_pct` | (number \| null)[] | Buy and sell slippage at sizes_usd, %; null — not enough liquidity | | `contracts[].updated_at` | int \| null | Contract data update time | ## Prediction markets Prediction markets and sportsbook surebets: arbitrage bundles, platform status, analytics, smart money, large trades and traders. ### Prediction Arbitrage — `GET /predictions/arbitrage` Plans: Start, Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/pred-arbitrage Arbitrage across prediction platforms, as on the «Prediction arbitrage» page: each bundle is walked through the order books with fees and shows the trade size, profit in $ and %, APR and risks. Modes: exact — exactly matched events and dutch — an outcome set on one platform (Start, Pro, Max); llm — AI-verified pairs and sport — bookmaker surebets (Pro and Max). When a leg is a bookmaker, profit_usd is null: the bookmaker's stake limits are unknown. Modes `exact` and `dutch`: Start, Pro, Max; `llm` and `sport`: Pro, Max. Query parameters: | Parameter | Type | Description | |---|---|---| | `mode` | string | exact (default) and dutch — Start, Pro, Max; llm and sport — Pro and Max | | `category` | string | Filter by category | | `platform` | string | At least one leg on this platform or bookmaker; several — comma-separated | | `min_profit_pct` | number | Minimum profit, % | | `min_profit_usd` | number | Minimum profit, USD (rows with profit_usd = null are skipped) | | `min_apr` | number | Minimum APR, % | | `max_days` | number | At most this many days to resolution | | `sport / league` | string | Sport and league for mode=sport, exact match. Sport codes: soccer, basketball, hockey, american_football, baseball, tennis, mma, boxing, volleyball, handball, table_tennis, cricket, rugby, darts, snooker, futsal, esports_cs2, esports_dota2, esports_lol, esports_valorant, esports_other | Example request: ```bash curl "https://api.genesisarbitrage.com/v1/predictions/arbitrage?mode=exact" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" ``` Example response (one data entry): ```json { "id": "x:exact:kalshi:KXFRENCHPRES-27-JCAS~polymarket:0x8c1f…a93a", "kind": "cross", "match": "exact", "title": "Will Jean Castex win the 2027 French presidential election?", "category": "Elections", "event_id": null, "group_id": "g:cd2ffb419bd1", "ends_at": 1843308000, "days_left": 562.87, "starts_at": null, "size_usd": 107175.08, "fees_usd": 28.08, "profit_usd": 153.69, "profit_pct": 0.14, "apr_pct": 0.1, "edge_cents": 0.18, "shares": 107356.85, "risks": ["rules_differ", "end_mismatch"], "first_seen": 1794526832, "updated_at": 1794675861, "legs": [ { "market": "polymarket:0x8c1f…a93a", "platform": "polymarket", "side": "yes", "outcome": "Jean Castex", "price_best": 0.001, "price_avg": 0.0013, "price_worst": 0.002, "shares": 107356.85, "cost_usd": 140.3, "fee_usd": 5.6, "url": "https://polymarket.com/event/next-french-presidential-election" }, { "market": "kalshi:KXFRENCHPRES-27-JCAS", "platform": "kalshi", "side": "no", "outcome": "No", "price_best": 0.997, "price_avg": 0.997, "price_worst": 0.997, "shares": 107356.85, "cost_usd": 107034.78, "fee_usd": 22.48, "url": "https://kalshi.com/events/KXFRENCHPRES-27" } ] } ``` Example mode=sport row: ```json { "id": "s:8812:RT:TOT:2.5:", "kind": "sport", "match": "sport", "title": "Arsenal — Chelsea", "category": "sports", "sport": "soccer", "league": "Premier League", "teams": ["Arsenal", "Chelsea"], "market_type": "TOT", "period": "RT", "line": 2.5, "score": null, "starts_at": 1794700800, "size_usd": 1000, "profit_usd": null, "profit_pct": 2.39, "legs": [ { "platform": "polymarket", "side": "yes", "outcome": "Over 2.5", "covers": ["O"], "price_avg": 0.505, "odds": null, "stake_unit": 0.505, "currency": "USD", "url": "https://polymarket.com/…" }, { "platform": "fonbet", "side": "bet", "outcome": "Under 2.5", "covers": ["U"], "odds": 2.12, "stake_unit": 0.471698, "currency": "RUB", "url": "https://www.fon.bet/…" } ] } ``` Response fields: | Field | Type | Description | |---|---|---| | `id` | string | Stable bundle id | | `kind` | string | cross — platform pair, dutch — outcome set, sport — bookmaker surebet | | `match` | string | exact, llm or sport | | `title / category` | string | Event or market title and category | | `event_id / group_id` | string \| null | Event and pair-group ids | | `ends_at / days_left / starts_at` | number \| null | Resolution time, days to resolution and match start (unix seconds) | | `size_usd / fees_usd` | number | Trade size and fees, USD | | `profit_usd / profit_pct` | number \| null | Profit in USD and % of the stake; profit_usd = null — a bookmaker leg | | `apr_pct` | number \| null | APR, % (null when under one day) | | `edge_cents` | number | Price edge, cents per share | | `shares` | number | Shares in the bundle | | `risks` | string[] | Risk codes: different rules, different resolution dates, etc. | | `first_seen / updated_at` | number | When the bundle appeared and was updated | | `legs[].market / platform` | string | The leg's market and platform or bookmaker | | `legs[].side / outcome` | string | What to buy — yes, no or bet (bookmaker stake) — and the outcome | | `legs[].price_best / price_avg / price_worst` | number | Best, average and worst price when walking the book | | `legs[].shares / cost_usd / fee_usd / url` | mixed | The leg's shares, cost, fee and link | | `sport / league / teams / flags` | mixed | For sport: sport, league, teams, flags | | `market_type / period / line / score` | mixed | For sport: market type (WIN, HCP, TOT, BTTS, CS), period, line, score | | `legs[].covers / odds / stake_unit / currency` | mixed | For sport: outcomes the leg covers, odds, stake share and the bookmaker's currency | ### Platform status — `GET /predictions/platforms` Plans: Start, Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/pred-platforms State of the prediction platforms and bookmakers: feed mode, time of the latest quotes and full scan, number of markets and events — shows how fresh the arbitrage data is. Example request: ```bash curl "https://api.genesisarbitrage.com/v1/predictions/platforms" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" ``` Example response (one data entry): ```json { "platforms": [ { "platform": "polymarket", "mode": "ws", "quotes_at": 1794675860, "full_scan_at": 1794675851, "markets": 18943, "hot_markets": 412 }, { "platform": "kalshi", "mode": "rest", "quotes_at": 1794675858, "full_scan_at": 1794675012, "markets": 26187, "hot_markets": 188 } ], "bookmakers": [ { "bookmaker": "fonbet", "title": "Fonbet", "ok": true, "events": 1840, "matched_events": 212, "updated_at": 1794675855, "currency": "RUB" } ] } ``` Response fields: | Field | Type | Description | |---|---|---| | `platforms[]` | array | Platform: feed mode (ws, rest, down), time of the latest quotes and full scan, markets total and hot | | `bookmakers[]` | array | Bookmaker: whether collection works, events total and matched, update time, currency | ### Market analytics — `GET /predictions/analytics` Plans: Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/pred-analytics Prediction market analytics, as on the «Analytics» page: open interest and volume KPIs, the strongest price moves over 1h and 24h, money flows, markets resolving soon, new markets and categories. Example request: ```bash curl "https://api.genesisarbitrage.com/v1/predictions/analytics" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" ``` Example response (one data entry): ```json { "kpi": { "oi_total": 1032456789, "vol24_total": 214567890, "big_24h": 418, "whales_24h": 37, "new_24h": 512, "closed_24h": 640 }, "moves_1h": [ … ], "moves_24h": [ … ], "flow_1h": [ … ], "flow_24h": [ … ], "flow_7d": [ … ], "resolving": [ … ], "new_markets": [ … ], "categories": [ … ] } ``` Response fields: | Field | Type | Description | |---|---|---| | `kpi` | object | KPIs: open interest, volume, large trades, whales, new and closed markets | | `moves_1h / moves_24h` | array | Strongest price moves over 1h and 24h (20 each) with a 24h sparkline | | `flow_1h / flow_24h / flow_7d` | array | Money flows over 1h, 24h and 7d (15 each) | | `resolving / new_markets / categories` | array | Markets resolving soon, new markets (20 each) and categories | ### Smart money — `GET /predictions/smart-money` Plans: Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/pred-smart Smart money, as on the site page: large trades and whales over 24h, flows, insider patterns, position concentration and smart money vs price. The insider label is a behaviour pattern, not proof. Example request: ```bash curl "https://api.genesisarbitrage.com/v1/predictions/smart-money" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" ``` Example response (one data entry): ```json { "kpi": { "big_24h": 418, "big_24h_usd": 18234567, "whales_24h": 37, "net_yes_24h": 2345678, "threshold_usd": 5000, "insiders_24h": 6 }, "flow_1h": [ … ], "flow_24h": [ … ], "flow_7d": [ … ], "insiders": [ … ], "concentration": [ … ], "smart_vs_price": [ … ] } ``` Response fields: | Field | Type | Description | |---|---|---| | `kpi` | object | KPIs: open interest, volume, large trades, whales, new and closed markets | | `flow_1h / flow_24h / flow_7d` | array | Money flows over 1h, 24h and 7d (15 each) | | `insiders / concentration / smart_vs_price` | array | Insider patterns, position concentration, smart money vs price (20 each) | ### Large trades — `GET /predictions/trades` Plans: Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/pred-trades Polymarket trade tape: live — trades from $1000 and smart wallets from $100, today and 7d — takers from $5000. Rows go from newest to oldest. Query parameters: | Parameter | Type | Description | |---|---|---| | `period` | string | live (default), today or 7d | | `wallet` | string | Wallet address | | `category` | string | Filter by category | | `side` | string | buy or sell | | `min_usd` | number | Minimum amount, USD | | `insider` | boolean | true — insider-labelled trades only | Example request: ```bash curl "https://api.genesisarbitrage.com/v1/predictions/trades?period=live" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" ``` Example response (one data entry): ```json { "id": "0x9f…:7134…:0x3a…", "ts": 1794675812, "wallet": "0x3a1c…f09e", "name": "Domer", "tags": ["whale", "smart"], "market": "polymarket:0x6d2b…", "title": "Will Bitcoin reach $150k in 2026?", "outcome": "No", "outcome_index": 1, "category": "Crypto", "side": "buy", "price": 0.82, "shares": 30487.8, "usd": 25000, "role": "taker", "first_in_market": false, "insider": false, "url": "https://polymarket.com/event/…", "bid_now": 0.81, "ask_now": 0.83 } ``` Response fields: | Field | Type | Description | |---|---|---| | `id / ts` | string / number | Trade id and time | | `wallet / name / tags` | mixed | Wallet, name and labels (whale, smart, etc.) | | `market / title / outcome / outcome_index / category` | mixed | Market, title, outcome and its index, category | | `side / price / shares / usd` | mixed | Side, price, shares and USD amount | | `role / first_in_market` | string / boolean | taker — the trade's initiator, maker; whether it is the wallet's first trade in the market | | `insider` | boolean | Insider pattern label | | `url` | string | Event link on the platform | | `bid_now / ask_now` | number \| null | Current bid and ask of the outcome | ### Trader leaderboard — `GET /predictions/traders` Plans: Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/pred-traders Top 300 Polymarket traders by PnL for the period: PnL, ROI, won positions, volume, categories and a PnL sparkline. Query parameters: | Parameter | Type | Description | |---|---|---| | `period` | string | 30d (default), 7d or all | Example request: ```bash curl "https://api.genesisarbitrage.com/v1/predictions/traders?period=30d" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" ``` Example response (one data entry): ```json { "wallet": "0x3a1c…f09e", "name": "Domer", "created_at": 1652000000, "tags": ["whale", "smart"], "score": 87.4, "pnl_usd": { "all": 2845123.5, "d30": 184220.1, "d7": 40912.7 }, "roi_pct": 21.4, "won": 412, "resolved": 590, "volume_usd": 13560000, "trades": 9821, "avg_trade_usd": 1380.6, "value_usd": 512400, "categories": ["Politics", "Crypto"], "ranks": { … }, "pnl_series": [2510000.4, 2534000.9, …], "open_positions": 64, "last_trade_at": 1794675812, "updated_at": 1794675800 } ``` Response fields: | Field | Type | Description | |---|---|---| | `wallet / name / created_at / tags` | mixed | Wallet, name, creation date and labels | | `score` | number | Trader score | | `pnl_usd.all / d30 / d7` | number | PnL all time, 30 and 7 days, USD | | `roi_pct` | number | ROI, % | | `won / resolved` | number | Positions won out of resolved | | `volume_usd / trades / avg_trade_usd / value_usd` | number | Volume, number of trades, average trade and positions value, USD | | `categories / ranks` | mixed | Categories and leaderboard ranks | | `pnl_series` | number[] | PnL sparkline (up to 30 points) | | `open_positions / last_trade_at / updated_at` | number | Open positions, last trade and update time | ## Funding Perpetual futures funding rates across exchanges, the best funding spread and historical settled-funding analytics. ### Funding rates — `GET /funding/rates` Plans: Trial, Start, Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/funding-rates Funding rates across all exchanges. Rates are normalized to 8 hours for comparison. Query parameters: | Parameter | Type | Description | |---|---|---| | `coin` | string | Filter by coin ticker (e.g. BTC) | | `exchange` | string | Filter by exchange; comma-separated for several | Example request: ```bash curl "https://api.genesisarbitrage.com/v1/funding/rates" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" ``` Example response (one data entry): ```json { "coin": "TON", "exchanges": [ { "exchange": "MEXC", "funding_pct": 0.02, "funding_8h_pct": 0.04, "next_payout": "00:00", "interval": "4h", "price": 2.184, "trade_url": "https://futures.mexc.com/exchange/TON_USDT" } ] } ``` Response fields: | Field | Type | Description | |---|---|---| | `coin` | string | Coin ticker | | `exchanges[].exchange` | string | Exchange | | `exchanges[].funding_pct` | number | Funding rate per interval, % | | `exchanges[].funding_8h_pct` | number \| null | Rate normalized to 8 hours, % | | `exchanges[].next_payout` | string \| null | Next payout time (HH:MM UTC, null — no data) | | `exchanges[].interval` | string \| null | Funding interval (e.g. 8h) | | `exchanges[].price` | number \| null | Price | | `exchanges[].trade_url` | string | Trading terminal link | ### Funding spread — `GET /funding/spread` Plans: Trial, Start, Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/funding-spread The best exchange pair by funding spread for every coin, plus the rest of the exchanges. Query parameters: | 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 data entry): ```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 | ### Funding analytics Plans: Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/funding-analytics Historical settled-funding analytics across 13 exchanges — a section of four endpoints. All rates are percent per settlement period, timestamps are epoch seconds UTC. Available on Pro and Max; other plans get 403 plan_restricted. Full sections are large — use the coin parameter and the If-None-Match header (the ETag follows generated_at). Full section downloads without coin are limited: summary and recent — once per 60 seconds, daily — once per 300 seconds per key; 304 replies and coin requests are unlimited. ### Analytics: summary — `GET /funding/analytics/summary` Plans: Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/funding-analytics Historical settled-funding summary for every coin×exchange pair: accumulated sums, average 8h rates, APR and coverage across 7 periods from 1 day to a year. Available on Pro and Max. The full section is ~600 KB gzip — use the coin parameter for a single coin; pass If-None-Match when polling (ETag changes every ~15 min). Query parameters: | Parameter | Type | Description | |---|---|---| | `coin` | string | Return a slice for a single coin only (recommended: the full section is large) | Example request: ```bash curl "https://api.genesisarbitrage.com/v1/funding/analytics/summary" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" ``` Example response (one data entry): ```json { "success": true, "data": { "schema_version": 1, "units": "percent", "generated_at": 1785546602, "metric_order": ["sum","avg8h","apr","n","pos","neg","zero","min","max","cov", "med8h","pos_streak","neg_streak","flips"], "periods": ["1d","3d","7d","30d","90d","180d","365d"], "coins": { "BTC": { "canon": "BTC", "mult": 1, "exchanges": { "Binance": { "raw_symbol": "BTCUSDT", "interval_h": 8.0, "data_since": 1568102400, "last8h": 0.004123, "m": { "7d": [0.12802, 0.006298, 6.896, 21, 21, 0, 0, 0.000125, 0.01, 1.0, 0.00588, 7, 0, 0] } } } } } }, "meta": { "count": 1710, "updated_at": 1785546602, "schema_version": 1 } } ``` Response fields: | Field | Type | Description | |---|---|---| | `metric_order` | string[] | Metric order inside the m array: sum, avg8h, apr, n, pos, neg, zero, min, max, cov | | `periods` | string[] | Available periods 1d…365d; a period is absent from m when there is no data at all | | `coins.{c}.canon / mult` | string / number | Canonical coin name for merging variants (1000PEPE→PEPE) and the contract multiplier; mult never applies to rates | | `…exchanges.{ex}.interval_h` | number | Settlement interval in hours: 8/4 on CEX, 1 on Hyper and Lighter | | `…exchanges.{ex}.data_since` | number | Where the data starts (epoch seconds); do not draw zeros before this date | | `…exchanges.{ex}.last8h` | number \| null | Latest actual rate in 8h equivalent — the “now vs norm” comparison | | `…exchanges.{ex}.m.{period}` | (number \| null)[14] | Period metric array in metric_order (14 fields: sum, avg8h, apr, n, pos, neg, zero, min, max, cov, med8h, pos_streak, neg_streak, flips); indices 10–13 are null for the 1d and 3d periods | | `m[9] (cov)` | number 0..1 | Period coverage 0..1; below 0.9 the data covers part of the period — flag it in the UI | ### Analytics: payouts 7d — `GET /funding/analytics/recent` Plans: Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/funding-analytics Every funding payout of the last 7 days for 1D/3D/7D charts. Rates are percent per settlement period, timestamps are epoch seconds UTC. Pro and Max; the full section is ~1 MB gzip — coin is recommended. Query parameters: | Parameter | Type | Description | |---|---|---| | `coin` | string | Return a slice for a single coin only (recommended: the full section is large) | Example request: ```bash curl "https://api.genesisarbitrage.com/v1/funding/analytics/recent" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" ``` Example response (one data entry): ```json { "success": true, "data": { "units": "percent", "generated_at": 1785546602, "days": 7, "coins": { "BTC": { "Lighter": { "i": 1.0, "s": "1784941200:0.0012;1784944800:0.001;1784948400:0.0002" } } } }, "meta": { "count": 1710, "updated_at": 1785546602, "schema_version": 1 } } ``` Response fields: | Field | Type | Description | |---|---|---| | `days` | number | Data depth of the section in days | | `coins.{c}.{ex}.i` | number | Settlement interval in hours: 8/4 on CEX, 1 on Hyper and Lighter | | `coins.{c}.{ex}.s` | string | Point string ts:rate;ts:rate;… ascending by time; ts is epoch seconds | ### Analytics: days 1y — `GET /funding/analytics/daily` Plans: Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/funding-analytics Daily funding sums over 365 days for 1M/3M/1Y charts. Once history fills up the section is large (~12 MB gzip) — use coin and If-None-Match; regenerated hourly. Query parameters: | Parameter | Type | Description | |---|---|---| | `coin` | string | Return a slice for a single coin only (recommended: the full section is large) | Example request: ```bash curl "https://api.genesisarbitrage.com/v1/funding/analytics/daily" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" ``` Example response (one data entry): ```json { "success": true, "data": { "units": "percent", "generated_at": 1785546602, "days": 365, "coins": { "BTC": { "OKX": "1784937600:0.0027:1:1;1785024000:0.008:3:0" } } }, "meta": { "count": 1710, "updated_at": 1785546602, "schema_version": 1 } } ``` Response fields: | Field | Type | Description | |---|---|---| | `days` | number | Data depth of the section in days | | `coins.{c}.{ex}` | string | Day string day_ts:sum:pos:neg;… — UTC midnight, day sum, positive and negative settlement counts | ### Analytics: screener — `GET /funding/analytics/top` Plans: Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/funding-analytics A ready-made screener: top-50 coin×exchange pairs by accumulated funding and top-50 exchange bundles (short/long) per period. Bundle legs are always on different exchanges with coverage ≥0.9. gross is before fees, net is after the taker fees of four trades; the price difference between the legs is not included. Pro and Max. Example request: ```bash curl "https://api.genesisarbitrage.com/v1/funding/analytics/top" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" ``` Example response (one data entry): ```json { "success": true, "data": { "schema_version": 1, "units": "percent", "generated_at": 1785545651, "taker_fees": { "Binance": 0.05, "Bybit": 0.055, "HTX": 0.05, "Hyper": 0.045, "Lighter": 0.0 }, "periods": { "7d": { "by_net_apr": [ { "coin": "PEPE", "short_ex": "HTX", "short_sym": "PEPE", "short_iv": 8.0, "long_ex": "Hyper", "long_sym": "1000PEPE", "long_iv": 1.0, "gross": 1.51504, "fees": 0.19, "net": 1.32504, "apr_net": 69.09, "apr_capital": 34.55, "win_rate": 1.0, "max_dd": 0.0, "worst_streak": 0, "risk_days": 7, "trend_1d": 0.0471, "trend_7d": 1.515, "live_8h": 0.012, "price_div": 0.11, "cov": 1.0 } ], "by_stable": [ { "...": "same shape, win_rate >= 0.7" } ], "by_live": [ { "...": "same shape, live_8h > 0 and trend_1d > 0" } ], "by_sum_pos": [ { "coin": "AAOI", "canon": "AAOI", "ex": "Lighter", "sum": 11.5165, "apr": 600.5, "cov": 1.0, "med8h": 0.062, "pos_streak": 7, "neg_streak": 0, "flips": 0, "iv": 1.0, "last8h": 0.058 } ], "by_sum_neg": [ { "...": "same shape as by_sum_pos" } ] } } }, "meta": { "count": 7, "updated_at": 1785545651, "schema_version": 1 } } ``` Response fields: | Field | Type | Description | |---|---|---| | `taker_fees` | object | The taker-fee table applied when computing fees | | `periods.{p}.by_net_apr / by_stable / by_live` | array | by_net_apr — ranked by net yield; by_stable — win_rate ≥ 0.7 and drawdown ≤ half of gross; by_live — live_8h > 0 and trend_1d > 0; by_sum_pos / by_sum_neg — single-exchange tops | | `bundle.gross / fees / net` | number | net = gross − fees: the bundle's result after four trade fees; rows with net ≤ 0 never appear in the lists | | `bundle.apr_net / apr_capital` | number | apr_net — annualized on one leg's notional; apr_capital = apr_net / 2 — annualized on invested capital (both legs need funding) | | `bundle.win_rate / max_dd / worst_streak / risk_days` | number | win_rate — share of profitable days (0..1), max_dd — max drawdown of the cumulative curve, worst_streak — longest run of losing days, risk_days — days the risk was measured over (max 90) | | `bundle.live_8h / trend_1d / trend_7d / price_div` | number \| null | live_8h — current rate difference in 8h equivalent; trend_1d / trend_7d — gross spread over the last day and week; price_div — current futures price divergence (null when prices unavailable) | | `bundle.short_sym / long_sym` | string | Actual leg tickers on the exchanges — may differ (PEPE vs 1000PEPE) | | `periods.{p}.by_sum_pos / by_sum_neg` | array | Top-50 by accumulated funding (cov ≥ 0.5 only) | ## Market Market screeners: fair price vs last price, CEX pumps and dumps, DEX token dumps and futures open interest. ### Fair - Last — `GET /market/fair-price` Plans: Trial, Start, Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/fair-price Deviations of the last price from fair value per exchange, with 5s/10s/30s/1m dynamics. Query parameters: | Parameter | Type | Description | |---|---|---| | `exchange` | string | Filter by exchange; comma-separated for several | | `coin` | string | Filter by coin ticker (e.g. BTC) | | `min_spread` | number | Minimum spread, % | Example request: ```bash curl "https://api.genesisarbitrage.com/v1/market/fair-price" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" ``` Example response (one data entry): ```json { "exchange": "ByBit", "coin": "0G", "fair_price": 0.192, "last_price": 0.192, "spread_pct": 0.0, "trade_url": "https://www.bybit.com/trade/usdt/0GUSDT", "fair_changes": { "s5": 0.0, "s10": 0.052, "s30": 0.052, "m1": 0.0 }, "last_changes": { "s5": 0.052, "s10": 0.052, "s30": 0.052, "m1": 0.0 } } ``` Response fields: | Field | Type | Description | |---|---|---| | `exchange` | string | Exchange | | `coin` | string | Coin ticker | | `fair_price` | number | Fair price | | `last_price` | number | Last price | | `spread_pct` | number | Spread, % | | `fair_changes / last_changes` | object | Changes over 5s / 10s / 30s / 1m, % | | `trade_url` | string | Trading terminal link | ### CEX Pumps - Dumps — `GET /market/pumps` Plans: Trial, Start, Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/pumps Sharp price moves on CEX: changes over 8 intervals from 5 seconds to 1 hour. Query parameters: | Parameter | Type | Description | |---|---|---| | `exchange` | string | Filter by exchange; comma-separated for several | | `coin` | string | Filter by coin ticker (e.g. BTC) | | `min_change` | number | Minimum absolute price change, % | Example request: ```bash curl "https://api.genesisarbitrage.com/v1/market/pumps" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" ``` Example response (one data entry): ```json { "exchange": "MEXC", "coin": "BTC", "price": 64267.9, "change_5s": 0.0, "change_10s": 0.0, "change_30s": 0.02, "change_60s": 0.06, "change_5m": 0.08, "change_15m": -0.06, "change_30m": -0.09, "change_1h": -0.2, "volume_24h": 2243246205, "funding_pct": 0.01, "contract": "0x7130d2a12b9bcbfae4f2634d864a1ee1ce3ead9c", "network": "BNB Smart Chain(BEP20)", "trade_url": "https://futures.mexc.com/exchange/BTC_USDT" } ``` Response fields: | Field | Type | Description | |---|---|---| | `exchange` | string | Exchange | | `coin` | string | Coin ticker | | `price` | number | Price | | `change_5s … change_1h` | number | Price change per interval, % | | `volume_24h` | number | 24h volume, USD | | `funding_pct` | number \| null | Funding rate per interval, % | | `contract` | string \| null | Contract address | | `network` | string \| null | Token network | | `trade_url` | string | Trading terminal link | ### DEX Dumps — `GET /market/dex-dumps` Plans: Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/dex-dumps Token crashes on DEX: price, liquidity, period changes and CEX listing status. Query parameters: | Parameter | Type | Description | |---|---|---| | `chain` | string | Filter by network | | `min_liquidity` | number | Minimum liquidity, USD | Example request: ```bash curl "https://api.genesisarbitrage.com/v1/market/dex-dumps" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" ``` Example response (one data entry): ```json { "ts": 1783203653, "coin": "ONLY", "name": "only one chance", "contract": "0x79f7d65bb0cc24ae37e1abcaeb0e463738544444", "chain": "bsc", "price": 0.00009884, "liquidity_usd": 30477.58, "market_cap": 98840, "volume_24h": 44769.92, "price_changes": { "m5": -58.03, "h1": 31.83, "h6": 31.83, "h24": 31.83 }, "quote_token": "WBNB", "pool_url": "https://dexscreener.com/bsc/0x2a18…", "listed_on_cex": false, "cex_spot": [], "cex_futures": [], "links": [ { "text": "DexScreener", "url": "https://dexscreener.com/bsc/0x2a18…" }, { "text": "GMGN", "url": "https://gmgn.ai/bsc/token/0x79f7…" } ] } ``` Response fields: | Field | Type | Description | |---|---|---| | `ts` | int | Unix time of the event | | `coin` | string | Coin ticker | | `name` | string | Name | | `contract` | string | Contract address | | `chain` | string | Network | | `price` | number | Price | | `liquidity_usd` | number | Pool liquidity, USD | | `market_cap` | number \| null | Market cap, USD | | `volume_24h` | number \| null | 24h volume, USD | | `price_changes` | object | Price change over 5m / 1h / 6h / 24h, % | | `quote_token` | string | Pool quote token | | `pool_url` | string | Pool link | | `listed_on_cex` | boolean | Whether the coin trades on CEX | | `cex_spot / cex_futures` | string[] | CEXes with the coin's spot / futures | | `links` | array | Ready links: text + url | ### OI Tracking — `GET /market/open-interest` Plans: Trial, Start, Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/open-interest Futures open interest: totals per coin and per-exchange breakdown, with OI and price dynamics. Query parameters: | Parameter | Type | Description | |---|---|---| | `coin` | string | Filter by coin ticker (e.g. BTC) | | `exchange` | string | Filter by exchange; comma-separated for several | Example request: ```bash curl "https://api.genesisarbitrage.com/v1/market/open-interest" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" ``` Example response (one data entry): ```json { "coin": "GRAM", "total": { "oi_usd": 96544685.3, "oi_tokens": 58105803.3, "avg_price": 1.661224, "volume_24h": 47010004.63, "oi_change_5m": 0.0196, "oi_change_15m": 0.0649, "oi_change_30m": 0.1115, "oi_change_1h": 0.3185, "price_change_5m": -0.0228, "price_change_15m": -0.2568, "price_change_30m": -0.3359, "price_change_1h": -0.1929 }, "exchanges": { "ByBit": { "price": 1.6609, "oi_usd": 26838489.41, "oi_tokens": 16159003.8, "volume_24h": 13935670.32, "oi_change_5m": -0.0062, "oi_change_1h": -0.097, "price_change_5m": -0.0241, "price_change_1h": -0.1683, "trade_url": "https://www.bybit.com/trade/usdt/GRAMUSDT" } } } ``` Response fields: | Field | Type | Description | |---|---|---| | `coin` | string | Coin ticker | | `total.oi_usd` | number | Open interest, USD | | `total.oi_tokens` | number | Open interest in coins | | `total.avg_price` | number | Average price across exchanges (simple mean) | | `total.volume_24h` | number | 24h volume, USD | | `total.oi_change_5m/15m/30m/1h` | number | OI change per interval, % | | `total.price_change_5m/15m/30m/1h` | number | Price change per interval, % | | `exchanges{}` | object | Same metrics per exchange + trade_url | ## On-chain On-chain monitoring: large transfers, exchange flows, team wallets, perp DEX positions, unlocks, claims, hacks, DEX swaps and analytics. ### Genesis Onchain — `GET /onchain/{section}` Plans: Start, Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/onchain On-chain monitoring: large transfers, CEX flows, mint & bridges, team wallets, Perp. DEX positions, unlocks, claims, coin flows and hacks. Without the section parameter all sections are returned at once. The field set depends on the section — see the field table below. Sections: `large-transfers` (Large token transfers), `cex-flows` (CEX deposits and withdrawals), `mint-bridge` (Mint and bridge activity), `team-wallets` (Team wallet movements), `perp-positions` (Large positions on perpetual DEXes), `unlocks` (Token unlocks), `claims` (Claims), `coin-traffic` (Aggregated coin flows), `hacks` (Hacks and exploits). GET /onchain without a section returns every section as an object keyed by section. Query parameters: | Parameter | Type | Description | |---|---|---| | `section` | string | Data section — see the table below; omit to get all sections | | `min_usd` | number | Minimum amount, USD | | `coin` | string | Coin ticker: rows of this coin only (hacks have no coin — empty list) | | `when` | string | For unlocks: upcoming or past | Example request: ```bash curl "https://api.genesisarbitrage.com/v1/onchain/coin-traffic" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" ``` Example response (one data entry): ```json { "ts": 1783802410, "token": "LAB", "token_name": "LAB", "direction": "deposit", "target": "Gate-io", "target_address": "0x8782163068c7cd74D2510768a61135C1e4Eb07b3", "target_explorer": "https://bscscan.com/address/0x8782…", "total_usd": 573796.98, "count": 18, "window_hours": 5.69, "avg_usd": 31878, "largest_usd": 59891.78, "first_seen": 1783781930, "transfers": [ { "ts": 1783788640, "usd": 59891.78, "from_name": "0xec01…d1a5", "from_address": "0xec01c918E2f700F47332Ddc2d216Ae9E747Bd1a5", "to_address": "0x035AE7d933dCBFE617fFbA194A88Af0c2867B90c", "tx_hash": "0xbf44850a7dc16086c08cfb…", "chain": "bsc", "explorer_url": "https://bscscan.com/tx/0xbf44…", "from_explorer": "https://bscscan.com/address/0xec01…", "to_explorer": "https://bscscan.com/address/0x035A…" } ] } ``` Response fields: | Field | Type | Description | |---|---|---| | `ts` | int | Unix time of the event | | `token / token_name` | string | Token ticker and full name | | `chain / chain_name` | string | Network | | `usd / amount` | number | Amount in USD and in tokens | | `from_* / to_*` | string | Sender and receiver: label, address, explorer link | | `tx_hash / explorer_url / arkham_url` | string | Transaction hash and explorer / Arkham links | | `direction` | string | Flow direction: deposit, withdrawal or transfer | | `target / target_address / target_explorer` | string | Flow target: label, full address and explorer link | | `total_usd / count / window_hours / avg_usd / largest_usd` | number | Flow metrics: total, transfer count, window, average and largest transfer | | `transfers[]` | array | Top transfers: amounts, addresses, hashes and links | | `side / size / price / platform` | mixed | For perp-positions: side (Long/Short), size, price, platform | | `unlock_percent / unlock_value_usd / hours_left / allocations` | mixed | For unlocks: unlock share and value, hours left, allocations | | `classification / technique / returned_funds` | mixed | For hacks: classification, attack technique, returned funds | | `links` | array | Ready links: text + url | ### DEX overview — `GET /onchain/dex-swaps` Plans: Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/onchain-swaps Large DEX swaps, as in «DEX overview»: live — the last 15 minutes, plus 1h, 6h, 24h and 7d windows. Each swap has a pool impact estimate, the price move after 30 s and 5 min and the trader label. Records are completed as they are verified (facts: pending → final) and can disappear if a swap turns out to be a liquidity reshuffle — match by id. Query parameters: | Parameter | Type | Description | |---|---|---| | `period` | string | live (15 minutes, default), 1h, 6h, 24h or 7d | | `chain` | string | Filter by network | | `side` | string | buy or sell | | `dex` | string | DEX; several — comma-separated | | `min_usd` | number | Minimum amount, USD | | `min_impact` | number | Minimum absolute pool impact, % | | `final` | boolean | true — verified swaps only (facts = final) | | `token` | string | Token ticker | | `q` | string | Search across token, name, addresses, trader, tx hash, DEX and chain | Example request: ```bash curl "https://api.genesisarbitrage.com/v1/onchain/dex-swaps?period=live" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" ``` Example response (one data entry): ```json { "id": "ethereum:0x5f3c…e1:0x6982…1933", "ts": 1794675511, "published_at": 1794675523, "token": "PEPE", "token_name": "Pepe", "token_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933", "chain": "ethereum", "chain_name": "Ethereum", "side": "buy", "amount": 41250000000, "usd": 412500, "dex": "Uniswap", "pool_address": "0xa43f…", "pool_label": "PEPE/WETH 0.3%", "trader_address": "0x7b9e…", "trader_name": "Wintermute", "tier": "T3", "pool_liquidity_usd": 4120000, "size_pct_liquidity": 10.01, "impact_est_pct": 4.8, "price_usd": 0.00001, "move_after_5m_pct": 1.9, "facts": "final", "tx_hash": "0x5f3c…e1", "explorer_url": "https://etherscan.io/tx/0x5f3c…e1", "dexscreener_url": "https://dexscreener.com/ethereum/0xa43f…" } ``` Response fields: | Field | Type | Description | |---|---|---| | `id` | string | Stable id: chain, transaction, token | | `ts / published_at` | int | Swap and publication time | | `token / token_name / token_address` | string | Token: ticker, name, contract address | | `chain / chain_name` | string | Network | | `side / amount / usd` | mixed | Side buy or sell, amount and USD value | | `dex / dex_entity / pool_address / pool_label / route` | mixed | DEX, its entity, pool, pool label and route | | `trader_address / trader_name / trader_type / trader_url` | string \| null | Trader: address, label, type and link | | `tier` | string | Tier by pool liquidity: from T1 ($30K–100K) to T4 (over $10M) | | `pool_liquidity_usd / size_pct_liquidity / impact_est_pct` | number \| null | Pool liquidity, the swap's share of it and the estimated price impact, % | | `price_usd / price_change_5m_pct / price_change_1h_pct / price_after_30s_usd / price_after_5m_usd / move_after_5m_pct` | number \| null | Price and its change before the swap and after 30 s / 5 min | | `facts / legs` | string / int | Verification status: pending, publish, 30s, final or unavailable; legs — number of legs | | `tx_hash / explorer_url / arkham_url / dexscreener_url` | string | Transaction hash and explorer / Arkham links | ### OnChain analytics — `GET /onchain/analytics` Plans: Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/onchain-analytics OnChain analytics for 24h or 7d, as on the «Analytics» page: KPIs, hourly buckets, shares by section and chain, exchange flows, address pairs, team wallets, perps, unlocks, claims and bridges, hacks, coins in focus and the event feed. Query parameters: | Parameter | Type | Description | |---|---|---| | `period` | string | 24h (default) or 7d | Example request: ```bash curl "https://api.genesisarbitrage.com/v1/onchain/analytics?period=24h" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" ``` Example response (one data entry): ```json { "period": "24h", "kpi": { "events": 1284, "usd": 912345678, "tokens": 211, "cex_in": 312456789, "cex_out": 287654321, "cex_net": 24802468 }, "hourly": { "step": 3600, "buckets": [ { "t": 1794589200, "count": { … }, "usd": { … }, "cex_in": 0, "cex_out": 0 } ] }, "exchange_flows": { "Binance": { "in_usd": 98123456, "out_usd": 87654321, "net": 10469135 } }, "pairs": [ … ], "team": { … }, "perps": { … }, "unlocks": { "upcoming": [ … ], "past": [ … ], "calendar": [ … ] }, "claims_bridges": { … }, "hacks": [ … ], "tokens": [ … ], "coverage": { … }, "events": [ … ] } ``` Response fields: | Field | Type | Description | |---|---|---| | `kpi / hourly` | object | Period KPIs and hourly buckets (1 h step for 24h, 6 h for 7d) | | `shares` | object | Event shares by section and chain | | `exchange_flows` | object | Exchange flows: in, out, net, top token | | `pairs / team / perps / unlocks / claims_bridges / hacks` | mixed | Address pairs, team wallets, perps, unlocks, claims and bridges, hacks | | `tokens` | array | Coins in focus (up to 40) with the largest event and CEX context | | `events / coverage` | mixed | Event feed of the period (up to 600) and coverage | ### OnChain coin — `GET /onchain/coin/{symbol}` Plans: Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/onchain-coin 7-day summary of one coin, as on the OnChain coin page: events, DEX swaps, unlocks and CEX context (price, OI, funding, best spread, networks, deposit and withdrawal). Rebuilt at most once every 10 seconds. Query parameters: | Parameter | Type | Description | |---|---|---| | `{symbol}` | string | Coin ticker in the path (1–32 characters) | Example request: ```bash curl "https://api.genesisarbitrage.com/v1/onchain/coin/ETH" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" ``` Example response (one data entry): ```json { "symbol": "PEPE", "name": "Pepe", "coin": "PEPE", "cex": { "coin": "PEPE", "price": 0.00001, "oi_usd": 412000000, "funding_8h": 0.0081, "best_spread": 0.42, "deposit": true, "withdraw": true, "nets": ["ETH", "BSC"], "markets": [ … ] }, "kpi": { "events": 38, "usd": 61234567, "cex_in": 21000000, "cex_out": 18500000, "swaps": 54, "dex_buy": 3120000, "dex_sell": 2890000 }, "by_section": { "large_tx": 12, "cex_deposits": 21, "team_wallets": 5 }, "events": [ … ], "events_total": 38, "swaps": [ … ], "swaps_total": 54, "unlocks": { "upcoming": [ … ], "past": [ … ] } } ``` Response fields: | Field | Type | Description | |---|---|---| | `symbol / name / coin` | string | Token ticker and full name | | `cex` | object \| null | CEX context: price, OI, funding, best spread, networks, deposit and withdrawal, markets | | `kpi / by_section` | object | Coin KPIs over 7 days and event counts by section | | `events / events_total / swaps / swaps_total` | mixed | Events and swaps (up to 2000) and their totals | | `unlocks.upcoming / past` | array | Upcoming and past unlocks | ## AI & search Genesis AI+ signals and the full coin profile across exchanges. ### AI Signals — `GET /ai/signals` Plans: Trial, Start, Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/ai-signals Genesis AI+ signals: ready setups with a quality grade, text in two languages and links. Query parameters: | Parameter | Type | Description | |---|---|---| | `category` | string | Signal grade: alpha, high, middle, risky or noise | | `coin` | string | Filter by coin ticker (e.g. BTC) | Example request: ```bash curl "https://api.genesisarbitrage.com/v1/ai/signals" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" ``` Example response (one data entry): ```json { "id": "1783198680493", "ts": 1783198680, "time": "2026-07-04T20:58:00Z", "coin": "UTYA", "pipeline": "public", "category": "noise", "message_ru": "Глянул на UTYA — DEX против MEXC Futures, это мимо…", "message_en": "Checked UTYA — DEX against MEXC Futures, it's a no-go…", "links": [ { "text": "DEX", "url": "https://dexscreener.com/ton/eqco…" }, { "text": "MEXC Futures", "url": "https://futures.mexc.com/exchange/UTYA_USDT" } ] } ``` Response fields: | Field | Type | Description | |---|---|---| | `id` | string | Signal id | | `ts` | int | Unix time of the event | | `time` | string | Time in ISO 8601 | | `coin` | string | Coin ticker | | `pipeline` | string | Signal source | | `category` | string | Grade: alpha, high, middle, risky or noise | | `message_ru / message_en` | string \| null | Signal text in Russian / English | | `links` | array | Ready links: text + url | ### Coin Search — `GET /coins/search` Plans: Trial, Start, Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/coin-search Full coin profile: contracts per network, prices and statuses on every exchange, funding. Query parameters: | Parameter | Type | Description | |---|---|---| | `query` | string | Coin ticker (required) | Example request: ```bash curl "https://api.genesisarbitrage.com/v1/coins/search?query=TON" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" ``` Example response (one data entry): ```json { "coin": "IRYS", "contracts": [ { "address": "0x91152b4ef635403efbae860edd0f8c321d7c035d", "network": "BNB Smart Chain(BEP20)", "exchanges": ["MEXC", "Ourbit"] } ], "exchanges": { "MEXC": { "spot_price": 0.01329, "futures_price": 0.0133, "deposit": true, "withdraw": true, "network": "BNB Smart Chain(BEP20)", "spot_url": "https://www.mexc.com/exchange/IRYS_USDT", "futures_url": "https://futures.mexc.com/exchange/IRYS_USDT" } }, "funding": { "spread_pct": 0.0, "best": { "exchange_1": "Bitget", "exchange_2": "OKX", "funding_1_pct": 0.01, "funding_2_pct": 0.0 } } } ``` Response fields: | Field | Type | Description | |---|---|---| | `coin` | string | Coin ticker | | `contracts[]` | array | Coin contracts: address, network and exchanges using it | | `exchanges{}` | object | Coin prices and statuses per exchange | | `exchanges{}.spot_price / futures_price` | number \| null | Spot / futures price (null — no market) | | `exchanges{}.deposit / withdraw` | boolean \| null | Whether deposits and withdrawals are open | | `exchanges{}.spot_url / futures_url` | string \| null | Trading terminal link | | `funding` | object \| null | Coin funding summary (null if no futures) | ## Account The state of your API key: plan, quota and limits. ### Usage — `GET /account/usage` Plans: Trial, Start, Pro, Max. Docs: https://genesisarbitrage.com/en/api/docs/usage Your key state: plan, used quota and limits. Example request: ```bash curl "https://api.genesisarbitrage.com/v1/account/usage" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" ``` Example response (one data entry): ```json { "plan": "pro", "calls_used": 184201, "calls_limit": 5000000, "rps_limit": 5, "freshness_sec": 10, "period_resets_at": 1786492800 } ``` Response fields: | Field | Type | Description | |---|---|---| | `plan` | string | Your plan | | `calls_used` | int | Calls used in the current period | | `calls_limit` | int | Call quota per period | | `rps_limit` | int | Requests-per-second limit | | `freshness_sec` | int | Data delay, seconds | | `period_resets_at` | int | Unix time when the quota resets | ## Terms Yes. Build your own services, bots and dashboards on Genesis API. The only restriction — you can't resell the raw data as is.