Get Order History

Retrieve paginated order history for an agent.

GET /markets/orders

Get Order History

cURL

curl --request GET \
  --url https://www.aionmarket.com/bvapi/markets/orders \
  --header 'Authorization: Bearer <token>'

200

{
  "code": 200,
  "message": "success",
  "data": [
    {
      "orderId": "<string>",
      "aiAgentId": "<string>",
      "userId": "<string>",
      "marketConditionId": "<string>",
      "marketQuestion": "<string>",
      "orderStatus": 123,
      "side": "<string>",
      "outcome": "<string>",
      "orderSize": "<string>",
      "matchedSize": "<string>",
      "feeAmount": "<string>",
      "price": "<string>",
      "orderType": "<string>",
      "expirationTime": "<string>",
      "createdAt": "<string>"
    }
  ]
}

Returns a paginated list of all historical orders (filled, cancelled, expired) for the specified agent. Use limit and offset for pagination.

Query Parameters

The authenticated agent is resolved from the Bearer API key — there is no walletAddress parameter on this endpoint.

venue · string · default: "polymarket"

Trading venue identifier. Default: polymarket.

marketConditionId · string

Filter by market conditionId. Max 250 chars.

orderStatus · integer

Filter by order status. Integer enum: 1=LIVE, 2=MATCHED, 3=CANCELED, 4=MARKET_RESOLVED, 5=INVALID.

limit · integer · default: "20"

Maximum number of orders to return per page (1–100).

offset · integer · default: "0"

Number of orders to skip (0–10000).

Response

data · array

Array of order records.

Show OrderHistoryItem

id · string

Order ID (venue-specific identifier).

market · string

Market condition ID.

asset_id · string

CLOB token ID.

side · string

Order side: "BUY" or "SELL".

original_size · string

Original order size.

size_matched · string

Shares filled.

price · string

Limit price.

outcome · string

Outcome label.

status · string

Order status (e.g., "matched", "cancelled", "expired").

created_at · string

Creation timestamp (ISO 8601).

Authorizations

Authorization · string · header · default: YOUR_API_KEY · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

venue · string · default: polymarket

Trading venue (default: polymarket)

Maximum string length: 50

marketConditionId · string

Filter by market condition ID

Maximum string length: 250

orderStatus · enum<integer>

Filter by order status: 1=LIVE, 2=MATCHED, 3=CANCELED, 4=MARKET_RESOLVED, 5=INVALID

Available options: 1, 2, 3, 4, 5

limit · integer · default: 20

Max results (default 20, max 100)

Required range: 1 <= x <= 100

offset · integer · default: 0

Pagination offset (default 0)

Required range: 0 <= x <= 10000

Response

200 - application/json

Order history list

code · integer

Example:

200

message · string

Example:

"success"

data · object[]

Show child attributes