Skip to main content
GET
/
api
/
v1
/
order_history
Get user order history
curl --request GET \
  --url https://api.mainnet.aptoslabs.com/decibel/api/v1/order_history \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "cancellation_reason": "<string>",
      "client_order_id": "<string>",
      "details": "<string>",
      "is_buy": true,
      "is_reduce_only": true,
      "is_tpsl": true,
      "market": "<string>",
      "order_direction": "<string>",
      "order_id": "<string>",
      "order_type": "<string>",
      "parent": "<string>",
      "status": "<string>",
      "transaction_version": 1,
      "trigger_condition": "<string>",
      "unix_ms": 1,
      "orig_size": 123,
      "price": 123,
      "remaining_size": 123,
      "size_delta": 123,
      "sl_limit_price": 123,
      "sl_trigger_price": 123,
      "tp_limit_price": 123,
      "tp_trigger_price": 123
    }
  ],
  "total_count": 1
}

Documentation Index

Fetch the complete documentation index at: https://docs.decibel.trade/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Bearer token from Geomi. See Authentication for setup instructions.

Query Parameters

account
string
required

User account address

market
string

Filter by market address

order_type
string

Filter by order type (e.g. "Limit", "Market", "Stop Limit", "Stop Market")

status
string

Filter by order status (e.g. "Open", "Filled", "Cancelled", "Expired")

reduce_only
boolean

Filter by reduce-only flag

Response

Order history retrieved successfully

items
object[]
required

The items in the current page

total_count
integer<int32>
required

The total number of items across all pages

Required range: x >= 0