Genesis API Documentation
Everything you need to integrate: authentication, limits, endpoints and response schemas.
DocumentationStock Arbitrage
Stock Arbitrage
TrialStartProMax
Spreads on tokenized stocks, metals, indices and commodities between CEX exchanges. The instrument ticker may differ per exchange.
GET
https://api.genesisarbitrage.com/v1/arbitrage/stocksTry it
GET
/v1/arbitrage/stocksThe 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 |
|---|---|---|
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 element of the data array is shown (real data):
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 |