> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trusset.org/llms.txt
> Use this file to discover all available pages before exploring further.
# Get User Trades
> List a wallet's fills across the security books you can reach
Returns trades where the wallet was maker or taker, newest first, across every external securities book your instance owns or has imported. Fills against a pooled peer appear here too, because a trade is recorded against both the maker's and the taker's book.
Read `settlementStatus` before treating a row as a completed transfer. On this venue a matched trade is not yet a settled one: it waits for the operator's signature, and a settlement whose revert is permanent is reversed rather than retried.
## Path Parameters
Wallet address. Matched case-insensitively.
## Query Parameters
Page size, capped at 100.
Rows to skip.
## Response Fields
Trade ID.
Maker's book.
Taker's book when the fill crossed a pooled peer, otherwise `null`.
`CLOB`.
Resting side.
Aggressing side.
Execution price in order book units.
Base quantity in order book units.
Fee charged to the maker, as base quantity in order book units.
Fee charged to the taker, as base quantity in order book units.
Side of the aggressing order.
Settlement grouping this trade, or `null`.
`AWAITING_SIGNATURE`, `CONFIRMED` or `FAILED`.
Why settlement failed, or `null`.
ISO 8601 timestamp.
The maker's book record.
Total matching trades.
Page size applied.
Offset applied.
```bash cURL theme={null}
curl "https://api.trusset.org/orderbooks/external-securities/api/users/0xabc7f1093d5e26b804a1c3f78de025916b47c0d3/trades?limit=50" \
-H "X-API-Key: trusset_your_key_here"
```
```typescript TypeScript theme={null}
const res = await fetch(
`https://api.trusset.org/orderbooks/external-securities/api/users/${address}/trades?limit=50`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
const unsettled = data.trades.filter((t: any) => t.settlementStatus === 'AWAITING_SIGNATURE');
```
```json Response theme={null}
{
"success": true,
"data": {
"trades": [
{
"tradeId": "5b3c19e0-7a42-4d86-91f5-2c0e8d47b613",
"orderBookId": "clx_ob_extsec_001",
"takerOrderBookId": null,
"origin": "CLOB",
"makerAddress": "0x9f8c1d4b2e7a3056c1b8f4d29e0a7c3518b6d24f",
"takerAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
"price": "104200000",
"quantity": "4000000",
"makerFee": "0",
"takerFee": "4000",
"side": "BUY",
"settlementId": "clx_settle_77",
"settlementStatus": "CONFIRMED",
"settlementError": null,
"createdAt": "2025-06-15T12:03:00.000Z",
"orderBook": { "id": "clx_ob_extsec_001", "symbol": "HELG" }
}
],
"total": 1,
"limit": 50,
"offset": 0
}
}
```
## Error Codes
| Code | HTTP | Cause |
| --------------------- | ----- | --------------------------------------------------- |
| `VALIDATION_ERROR` | `400` | `userAddress` is not a valid address |
| `SERVICE_NOT_ENABLED` | `403` | The Trading service is not enabled on this instance |