Trading Orders API — place and manage orders

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

Status	Description
`OPEN`	Order is resting in the orderbook, awaiting a match.
`PARTIALLY_FILLED`	Part of the order quantity has been matched; the remainder is still open.
`FILLED`	The full order quantity has been matched.
`CANCELLED`	The order was cancelled before it could be fully filled.

Place an order

POST /trading/orders

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

curl -X POST https://api.dubupay.com/api/v1/trading/orders \
  -H "X-Api-Key: dubu_sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "symbol": "USDT-NGN",
    "side": "buy",
    "type": "limit",
    "quantity": "50.00",
    "price": "1580.00"
  }'

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

GET /trading/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

curl "https://api.dubupay.com/api/v1/trading/orders?symbol=USDT-NGN&status=OPEN" \
  -H "X-Api-Key: dubu_sk_live_YOUR_API_KEY"

Get an order

GET /trading/orders/:id

Retrieve a single order by its ID.

Path parameters

string

required

The UUID of the order to retrieve.

Example

curl https://api.dubupay.com/api/v1/trading/orders/ord_abc123 \
  -H "X-Api-Key: dubu_sk_live_YOUR_API_KEY"

Cancel an order

DELETE /trading/orders/:id

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

curl -X DELETE https://api.dubupay.com/api/v1/trading/orders/ord_abc123 \
  -H "X-Api-Key: dubu_sk_live_YOUR_API_KEY"

List trade history

GET /trading/trades

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

curl https://api.dubupay.com/api/v1/trading/trades \
  -H "X-Api-Key: dubu_sk_live_YOUR_API_KEY"

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.

Overview

Auth

Payments

Trading

Commerce

Webhooks

Trading Orders API — place and manage orders

Order statuses

Place an order

Request body

Example

Response

List orders

Query parameters

Example

Get an order

Path parameters

Example

Cancel an order

Path parameters

Example

List trade history

Example

Response fields

​Order statuses

​Place an order

​Request body

​Example

​Response

​List orders

​Query parameters

​Example

​Get an order

​Path parameters

​Example

​Cancel an order

​Path parameters

​Example

​List trade history

​Example

​Response fields

Order statuses

Place an order

Request body

Example

Response

List orders

Query parameters

Example

Get an order

Path parameters

Example

Cancel an order

Path parameters

Example

List trade history

Example

Response fields