Open / filled / cancelled orders for a wallet.

status=open filters to active book orders (not cancelled, not fully filled). status=filled returns orders where filled >= quantity. status=cancelled returns cancelled orders. status=all returns everything.

GET /v1/users/{address}/orders

Error

A valid request URL is required to generate request examples

200

{
  "orders": [
    {
      "id": 0,
      "marketAddress": "<string>",
      "marketId": 0,
      "orderId": 0,
      "trader": "<string>",
      "side": "buy",
      "outcome": "yes",
      "price": 500,
      "quantity": "<string>",
      "filled": "<string>",
      "cancelled": true,
      "isMarketOrder": true,
      "orderTimestamp": 0,
      "refererAddress": "<string>",
      "txId": "<string>",
      "createdAt": "<string>"
    }
  ],
  "pagination": {
    "limit": 100,
    "nextCursor": "<string>",
    "page": 4503599627370495,
    "total": 4503599627370495
  }
}

Authorizations

Authorization · string · header · required

API key obtained from POST /v1/auth/keys.

Path Parameters

address · string · required

Alephium address (base58, optional :N group suffix).

Required string length: 30 - 80

Pattern: ^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz:]+$

Query Parameters

marketAddress · string

Alephium address (base58, optional :N group suffix).

Required string length: 30 - 80

Pattern: ^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz:]+$

status · enum<string> · default: open

Available options: open, filled, cancelled, all

limit · integer · default: 100

Required range: 1 <= x <= 200

cursor · string

page · integer

Required range: 0 <= x <= 9007199254740991

Response

200

application/json

Default Response

orders · object[] · required

Show child attributes

pagination · object · required

Pagination envelope returned alongside every list endpoint.

Show child attributes