Skip to main content
GET
/
v1
/
fills
curl
ADDR=0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb
curl "https://api.testnet.arcus.xyz/v1/fills?address=${ADDR}&limit=100"
{
  "fills": [
    {
      "tradeId": "<string>",
      "orderId": "<string>",
      "marketId": 32767,
      "marketDisplayName": "<string>",
      "originalSize": "<string>",
      "size": "<string>",
      "price": "<string>",
      "fee": "<string>",
      "createdAt": 123,
      "address": "<string>",
      "accountIndex": 4,
      "clientId": "<string>",
      "closedPnl": "<string>",
      "remainingSize": "<string>",
      "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 fills 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 (epoch ms, inclusive).

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

End timestamp filter (epoch ms, inclusive).

Required range: x >= 0

Response

List of fills.

​
fills
object[]
required