Agent-readable docs index: /llms.txt. Full docs in one file: /llms-full.txt. Download /docs.zip to grep all markdown files locally.

Fills

GET /v1/account/{addr}/fills
Needs a session for the address in the path.
The account's fills, newest first, each from the account's own side.
query limitintegerdefault: 100
At most 100, or 1,000 for a premium account. A larger value is cut to the most.
query beforeinteger
The seq of the last fill of the page before: the next page is the fills before it.
query envelope1
Wrap the answer as {"position", "fills"}.
[ { "seq": 55120, "ts": 199990001234, "underlyingKey": 7, "specifier": 859008923130267914, "side": 1, "size": 10, "price": 20000, "fee": 20000, "role": "maker", "close": 0, "open": 10, "positionAfter": -10, "nonce": 42 } ]
seq is the fill's stream position, which names it. close and open split the fill into the part that closed an existing position and the part that opened a new one; positionAfter is the net position after it. fee is what this account paid on it, in micro-USDC.
The fills come from the exchange's history; if it is away the answer is 503 with Retry-After: 1.