Skip to main content
GET
Get orderbook for integrators
Levels are [price, quantity] with the price in USDC per cNGN and the quantity in cNGN. bids are orders buying cNGN, highest price first; asks are orders selling it, lowest first. This is the same orientation as GET /v1/book, so nothing needs inverting between the two. Prices are rounded to 10 decimal places away from the touch — bids down, asks up — and quantities round down to 6 places, so no level shows a better price or more size than is resting. Orders whose prices round to the same level are summed into one; a level whose quantity rounds to 0 is dropped. The service reads at most the first 1000 resting orders per side when building levels. Responses are cached for up to 5 seconds and carry Cache-Control: public, max-age=5. The cache key is ticker_id and depth only; other query parameters do not bypass it.

Query Parameters

ticker_id
string
required

A ticker_id from GET /v1/integrations/tickers: cNGN-USDC or cNGN-PERP, matched exactly. The deprecated USDCcNGN-SPOT and USDCcNGN-PERP are accepted until 2027-01-06 and answered under the canonical ticker_id with Deprecation: true and X-Canonical-Market headers. An unknown value is rejected rather than answered with another market.

depth
integer
default:50

Maximum price levels per side.

Required range: 1 <= x <= 500

Response

Aggregated levels, best first

ticker_id
string
required
timestamp
integer
required

Unix milliseconds at which the book was read.

bids
tuple[]
required

Levels buying cNGN, highest price first. Empty array, never null, when there are none.

asks
tuple[]
required

Levels selling cNGN, lowest price first. Empty array, never null, when there are none.