Exchange API Documentation

This documentation describes the public API endpoints for accessing exchange market data. All endpoints return JSON responses.

Base URL:

Authentication

These endpoints are public and do not require authentication.

Rate Limits

The API has a rate limit of 60 requests per minute per IP address. Excessive requests may result in temporary restrictions.

Endpoint 1: Order Book Depth

Description

Retrieves the current order book (bids and asks) for a specified market pair.

Endpoint

GET /api/v2/orderbook/

Parameters

Parameter	Required	Type	Description
ticker_id	Yes	String	Market pair identifier in BASE_QUOTE format (e.g., "BTC_USDT")
depth	No	Integer	Number of orders to return for each side (default: 100, max: 1000)

Response Format

{
    "ticker_id": "BTC_USDT",
    "timestamp": 1634567890,
    "bids": [
        ["50000.00000000", "1.25000000"],
        ["49950.00000000", "2.10000000"]
    ],
    "asks": [
        ["50100.00000000", "0.75000000"],
        ["50150.00000000", "3.20000000"]
    ]
}

Response Fields

ticker_id: The market pair identifier
timestamp: Current UNIX timestamp
bids: Array of bid orders [price, volume], sorted highest price first
asks: Array of ask orders [price, volume], sorted lowest price first

Test Order Book API

Response will appear here...

Endpoint 2: Ticker Data

Description

Retrieves 24-hour market statistics for all available trading pairs.

Endpoint

GET /api/v2/tickers/

Parameters

None

Response Format

[
    {
        "ticker_id": "BTC_USDT",
        "base_currency": "BTC",
        "target_currency": "USDT",
        "last_price": "50123.45000000",
        "base_volume": "125.50000000",
        "target_volume": "6300000.00000000",
        "bid": "50100.00000000",
        "ask": "50150.00000000",
        "high": "50500.00000000",
        "low": "49800.00000000",
        "change_24h": "+2.45"
    }
]

Response Fields (per market)

ticker_id: Market pair identifier
base_currency: Base currency symbol
target_currency: Quote currency symbol
last_price: Last traded price
base_volume: 24-hour trading volume in base currency
target_volume: 24-hour trading volume in quote currency
bid: Current best bid price
ask: Current best ask price
high: Highest price in last 24 hours
low: Lowest price in last 24 hours
change_24h: Percentage price change with sign

Test Ticker API

Response will appear here...

Error Responses

Both endpoints return errors in the following format:

{
    "error": "Error message describing the issue"
}

Common Error Codes

400 Bad Request: Invalid parameters or missing required parameters
404 Not Found: Requested resource not found
500 Internal Server Error: Server-side error