Orders
Get User Trades
List a wallet’s fills across the security books you can reach
GET
/
orderbooks
/
external-securities
/
api
/
users
/
{userAddress}
/
trades
curl "https://api.trusset.org/orderbooks/external-securities/api/users/0xabc7f1093d5e26b804a1c3f78de025916b47c0d3/trades?limit=50" \
-H "X-API-Key: trusset_your_key_here"
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');
{
"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
}
}
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
string
required
Wallet address. Matched case-insensitively.
Query Parameters
integer
default:"50"
Page size, capped at 100.
integer
default:"0"
Rows to skip.
Response Fields
object
Show child attributes
Show child attributes
array
Show child attributes
Show child attributes
string
Trade ID.
string
Maker’s book.
string
Taker’s book when the fill crossed a pooled peer, otherwise
null.string
CLOB.string
Resting side.
string
Aggressing side.
string
Execution price in order book units.
string
Base quantity in order book units.
string
Fee charged to the maker, as base quantity in order book units.
string
Fee charged to the taker, as base quantity in order book units.
string
Side of the aggressing order.
string
Settlement grouping this trade, or
null.string
AWAITING_SIGNATURE, CONFIRMED or FAILED.string
Why settlement failed, or
null.string
ISO 8601 timestamp.
object
The maker’s book record.
integer
Total matching trades.
integer
Page size applied.
integer
Offset applied.
curl "https://api.trusset.org/orderbooks/external-securities/api/users/0xabc7f1093d5e26b804a1c3f78de025916b47c0d3/trades?limit=50" \
-H "X-API-Key: trusset_your_key_here"
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');
{
"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 |
⌘I
curl "https://api.trusset.org/orderbooks/external-securities/api/users/0xabc7f1093d5e26b804a1c3f78de025916b47c0d3/trades?limit=50" \
-H "X-API-Key: trusset_your_key_here"
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');
{
"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
}
}