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.

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

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
symbolstringFilter by instrument ticker
categorystringFilter by category
exchangestringFilter by exchange; comma-separated for several
min_spreadnumberMinimum 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

FieldTypeDescription
symbolstringInstrument ticker
categorystringCategory: Stock, Metal, Index or Commodity
exchange_buy / exchange_sellstringBuy / sell exchange
symbol_on_buy / symbol_on_sellstringInstrument ticker on this exchange
price_buy / price_sellnumberPrice on the buy / sell exchange
bid_* / ask_*number | nullBest bid and ask on each side
spread_pctnumberSpread, %
trade_url_buy / trade_url_sellstringTrading terminal link