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

symbol

string

required

The trading pair symbol. Supported values: USDT-NGN, USDC-NGN, USD-NGN.

side

string

required

Order direction. One of buy or sell.

type

string

required

Order type. One of limit or market.

quantity

string

required

The quantity of the base asset to buy or sell. Provided as a decimal string, e.g. "100.00".

price

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).

symbol

string

The trading pair, e.g. USDT-NGN.

side

string

buy or sell.

type

string

limit or market.

quantity

string

The original requested quantity.

filled_quantity

string

How much of the quantity has been matched so far.

price

string

The limit price. null for market orders.

status

string

Current order status: OPEN, PARTIALLY_FILLED, FILLED, or CANCELLED.

created_at

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

symbol

string

Filter to a specific trading pair, e.g. USDT-NGN.

status

string

Filter by order status. One of OPEN, PARTIALLY_FILLED, FILLED, or CANCELLED.

side

string

Filter by side. One of buy or sell.

page

number

Page number (1-indexed). Defaults to 1.

limit

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.

order_id

string

The order this trade belongs to.

symbol

string

Trading pair, e.g. USDT-NGN.

side

string

buy or sell.

quantity

string

Quantity filled in this trade.

price

string

Execution price for this fill.

created_at

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