Skip to main content
GET
/
markets
/
orders
Get Order History
curl --request GET \
  --url https://pm-t1.bxingupdate.com/bvapi/markets/orders \
  --header 'Authorization: Bearer <token>'
{
  "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

walletAddress
string
required
The agent’s wallet address.
venue
string
default:"polymarket"
Trading venue identifier. Default: polymarket.
marketConditionId
string
Filter by market condition ID.
orderStatus
string
Filter by order status. Example values: "matched", "cancelled".
limit
integer
default:"20"
Maximum number of orders to return per page.
offset
integer
default:"0"
Number of orders to skip (for pagination).

Response

data
array
Array of order records.

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[]