Skip to main content
GET
/
v1
/
orders
curl
ADDR=0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb
curl "https://api.testnet.arcus.xyz/v1/orders?address=${ADDR}&limit=100"

{
  "orders": [
    {
      "orderId": "<string>",
      "marketId": 32767,
      "marketDisplayName": "<string>",
      "price": "<string>",
      "originalSize": "<string>",
      "remainingSize": "<string>",
      "updatedAt": 123,
      "clientId": "<string>",
      "filledSize": "<string>",
      "avgFillPrice": "<string>",
      "goodTilTime": "<string>",
      "triggerPrice": "<string>",
      "isPositionTPSL": true,
      "parentOrderId": "<string>",
      "createdAt": 123,
      "sequenceNumber": 123
    }
  ]
}

Query Parameters

​
address
string
required

Master Ethereum address for this API key (must match address from POST /createApiKey for the same key). Required on REST for account-scoped reads and for place/cancel. Invalid hex → 400; mismatch with key → 403.

20-byte EVM address as hex: optional 0x or 0X prefix and exactly 40 hexadecimal digits. API responses normalize to lowercase a–f after 0x.

Pattern: ^(0x|0X)?[0-9a-fA-F]{40}$
​
limit
integer
default:1000

Maximum number of orders to return. Default and maximum are both 1000; requests above the maximum are silently clamped. Pass an explicit smaller value when you want fewer rows.

Required range: 1 <= x <= 1000
​
from
integer<int64>

Start timestamp filter on event_time (epoch ms, inclusive).

Required range: x >= 0
​
to
integer<int64>

End timestamp filter on event_time (epoch ms, inclusive).

Required range: x >= 0

Response

List of orders.

​
orders
object[]
required