Genesis API Documentation
Everything you need to integrate: authentication, limits, endpoints and response schemas.
DocumentationCoin Search
Coin Search
TrialStartProMax
Full coin profile: contracts per network, prices and statuses on every exchange, funding.
GET
https://api.genesisarbitrage.com/v1/coins/search?query={ticker}Try it
GET
/v1/coins/search?query=TONThe 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 |
|---|---|---|
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 element of the data array is shown (real data):
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) |