Genesis Arbitrage

Genesis Arbitrage · · Updated · 5 min read

Genesis API quick start: key, first request and limits

In short

  • Genesis API is REST access to Genesis Arbitrage data: CEX and DEX spreads, order books, funding, cross-chain, on-chain flows, prediction markets and Genesis AI+ signals.
  • Getting to your first request takes three steps: a plan, a key in your profile, and a GET request with the X-API-Key header.
  • Your plan sets the call quota, requests per second and data delay — from 60 seconds on Trial to 5 seconds on Max.

Genesis API serves Genesis Arbitrage data as a REST API: spreads between CEX and DEX, order books, funding, cross-chain, on-chain flows, prediction markets and Genesis AI+ signals. Every tool on the site is available as its own endpoint with a single JSON format. Your first request needs an API plan, a key and one HTTP header — no SDK is required, any language with an HTTP client will do.

Genesis API quick start: key, first request and limits
How it looks in Genesis Arbitrage

What the API covers

The endpoints mirror the sections of the site:

The data sets are described on the Genesis API page; the parameters and fields of each endpoint are in the documentation.

Plans and limits

The API has its own plans, separate from the site subscription: Trial, Start, Pro and Max. They differ in call quota, requests-per-second limit and data freshness.

API planCalls per monthData freshness
Trial500K60 s
Start2M30 s
Pro5M10 s
Max10M5 s

Trial costs $20 a month, and Max allows 15 requests per second. Endpoints that are not part of your plan return a 403 error with the plan_restricted code. Requests over the limits are not charged: wait for the new period or upgrade. Only 200 responses use the quota: errors and 304 responses are free. Prices and the full comparison are on the Genesis API Pricing page.

Your first request

  1. Pick a plan

    On the Genesis API Pricing page, choose a plan and period and click "Subscribe". Payment is in crypto, just like the site subscription. If another API plan is already active, paying for a new one replaces it and the remainder is forfeited — the site warns you first.

  2. Get your key

    In your profile, in the Genesis API block, click "Get key". A gns_live_… key appears in the "Your API key" window — click "Copy" and save it. It is shown only once.

  3. Make a request

    Send a plain HTTP GET and pass the key in the X-API-Key header. The base URL is https://api.genesisarbitrage.com/v1. A good first endpoint is /account/usage — it shows your plan and remaining quota.

  4. Parse the response

    A successful response comes in a single envelope: a data array and a meta block. If something goes wrong, check the error table below.

A curl example:

curl "https://api.genesisarbitrage.com/v1/account/usage" \
  -H "X-API-Key: gns_live_…"

The documentation has a "Try it" form: paste your key, click "Send request" and see a shortened response right on the page. The key is stored only in your browser.

Response format

Errors and limits

CodeMeaning
401The key is missing, invalid or revoked
403The endpoint is not part of your plan
404The endpoint or resource was not found
429Rate limit exceeded — see the X-RateLimit and Retry-After headers
500Internal error, retry later
503Data is being rebuilt, retry in a few seconds — see Retry-After

The X-RateLimit headers in every response show your requests-per-second limit, how many requests remain in the current window and when the window resets. The X-Quota headers show the call quota for the period, what is left and when it resets. Every response also carries an X-Request-Id: when contacting support, include it with the request time in UTC, the endpoint and the status. Never send the key itself.

What next

Questions and answers

How is Genesis API different from free exchange APIs?

Exchange APIs return the order books and tickers of one venue. Genesis API returns computed spreads across dozens of exchanges and networks, deposit and withdrawal flags, and data cleaned of illiquid pairs.

What happens if I exceed the limit?

The server responds with 429 and the X-RateLimit and Retry-After headers. Extra requests are not charged.

Can I change my API plan?

Yes. A new plan takes effect right after payment: the new limits and freshness apply immediately, the call quota starts from zero, and the rest of the previous plan is forfeited. Renewing the same plan adds days to the current term.

Can I use the data in my own product?

Yes, you can build your own services, bots and dashboards on Genesis API. You may not resell the raw data as is.