Skip to main content
The orders API lets you interact with the Dubu trading engine. You can place limit or market orders for any supported trading pair, track their lifecycle from open through to filled or cancelled, and view the individual trades that make up each fill. All endpoints require authentication via API key or JWT bearer token.

Order statuses

Place an order

Submit a new buy or sell order. For limit orders you must provide a price. For market orders the price field is ignored and the order executes at the best available price.

Request body

string
required
The trading pair symbol. Supported values: USDT-NGN, USDC-NGN, USD-NGN.
string
required
Order direction. One of buy or sell.
string
required
Order type. One of limit or market.
string
required
The quantity of the base asset to buy or sell. Provided as a decimal string, e.g. "100.00".
string
The limit price per unit of the base asset. Required when type is limit. Omit for market orders.

Example

Response

Returns 201 Created with the new order object.
string
Unique order identifier (UUID).
string
The trading pair, e.g. USDT-NGN.
string
buy or sell.
string
limit or market.
string
The original requested quantity.
string
How much of the quantity has been matched so far.
string
The limit price. null for market orders.
string
Current order status: OPEN, PARTIALLY_FILLED, FILLED, or CANCELLED.
string
ISO 8601 timestamp when the order was placed.

List orders

Returns a paginated list of your orders, optionally filtered by status, symbol, or side.

Query parameters

string
Filter to a specific trading pair, e.g. USDT-NGN.
string
Filter by order status. One of OPEN, PARTIALLY_FILLED, FILLED, or CANCELLED.
string
Filter by side. One of buy or sell.
number
Page number (1-indexed). Defaults to 1.
number
Number of results per page. Maximum 100. Defaults to 20.

Example

Get an order

Retrieve a single order by its ID.

Path parameters

string
required
The UUID of the order to retrieve.

Example

Cancel an order

Cancel an open or partially-filled order. You cannot cancel a fully FILLED order.

Path parameters

string
required
The UUID of the order to cancel.

Example

List trade history

Returns a paginated list of all executed trades — the individual fills that result from matched orders. Each trade record represents one match event with a quantity and execution price.

Example

Response fields

string
Unique trade identifier.
string
The order this trade belongs to.
string
Trading pair, e.g. USDT-NGN.
string
buy or sell.
string
Quantity filled in this trade.
string
Execution price for this fill.
string
ISO 8601 timestamp of when the trade was executed.