Skip to main content
GET
Get Orderbook

Overview

Get the current orderbook (market depth) for a specific trading pair. This endpoint does not require authentication.

Path Parameters

symbol
string
required
Trading pair symbolExample: USDT-NGNAllowed values: USDT-NGN, USDC-NGN, USD-NGN

Query Parameters

depth
integer
Number of price levels to returnDefault: 20Range: 1 to 100

Request Examples

Response

success
boolean
required
Indicates if the request was successful
message
string
required
Human-readable response message
data
object
required
Orderbook data

Success Response

Error Responses

Understanding the Orderbook

Bids vs Asks

Reading the Spread

The spread is the difference between the best ask and best bid:
A tighter spread indicates higher liquidity.

Rate Limits

  • 100 requests per minute per IP address
  • No authentication required

Next Steps

Place Order

Execute a trade at current market prices

List Markets

View all available markets