Trusset Protocol - Infrastructure for Asset Tokenization

GET

orderbooks

commodities

api

users

{userAddress}

trades

curl "https://api.trusset.org/orderbooks/commodities/api/users/0xabc7f1093d5e26b804a1c3f78de025916b47c0d3/trades?limit=50" \
  -H "X-API-Key: trusset_your_key_here"

const res = await fetch(
  `https://api.trusset.org/orderbooks/commodities/api/users/${address}/trades?limit=50`,
  { headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();

{
  "success": true,
  "data": {
    "trades": [
      {
        "tradeId": "b40e7c12-3a86-4d95-8f01-6e2c9a5d7031",
        "orderBookId": "clx_ob_comm_001",
        "takerOrderBookId": "clx_ob_comm_055",
        "origin": "CLOB",
        "makerAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
        "takerAddress": "0x9f8c1d4b2e7a3056c1b8f4d29e0a7c3518b6d24f",
        "price": "2410000000",
        "quantity": "2000000",
        "makerFee": "400",
        "takerFee": "1600",
        "side": "SELL",
        "settlementId": "clx_settle_92",
        "settlementStatus": "CONFIRMED",
        "settlementError": null,
        "createdAt": "2025-06-15T12:02:00.000Z",
        "orderBook": { "id": "clx_ob_comm_001", "symbol": "XAUA" }
      }
    ],
    "total": 1,
    "limit": 50,
    "offset": 0
  }
}

Returns trades where the wallet was maker or taker, newest first, across every commodity book your instance owns or has imported. Fills against a pooled peer in the same fungibility class appear here too, because a trade is recorded against both the maker’s and the taker’s book.

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

array

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

PROCESSING, CONFIRMED, FAILED, or null.

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.

This list is unfiltered by settlement outcome, so a trade whose settlement failed still appears. The market data reads take the opposite view and exclude failed trades from last price, volume and counts.

curl "https://api.trusset.org/orderbooks/commodities/api/users/0xabc7f1093d5e26b804a1c3f78de025916b47c0d3/trades?limit=50" \
  -H "X-API-Key: trusset_your_key_here"

const res = await fetch(
  `https://api.trusset.org/orderbooks/commodities/api/users/${address}/trades?limit=50`,
  { headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();

{
  "success": true,
  "data": {
    "trades": [
      {
        "tradeId": "b40e7c12-3a86-4d95-8f01-6e2c9a5d7031",
        "orderBookId": "clx_ob_comm_001",
        "takerOrderBookId": "clx_ob_comm_055",
        "origin": "CLOB",
        "makerAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
        "takerAddress": "0x9f8c1d4b2e7a3056c1b8f4d29e0a7c3518b6d24f",
        "price": "2410000000",
        "quantity": "2000000",
        "makerFee": "400",
        "takerFee": "1600",
        "side": "SELL",
        "settlementId": "clx_settle_92",
        "settlementStatus": "CONFIRMED",
        "settlementError": null,
        "createdAt": "2025-06-15T12:02:00.000Z",
        "orderBook": { "id": "clx_ob_comm_001", "symbol": "XAUA" }
      }
    ],
    "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

curl "https://api.trusset.org/orderbooks/commodities/api/users/0xabc7f1093d5e26b804a1c3f78de025916b47c0d3/trades?limit=50" \
  -H "X-API-Key: trusset_your_key_here"

const res = await fetch(
  `https://api.trusset.org/orderbooks/commodities/api/users/${address}/trades?limit=50`,
  { headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();

{
  "success": true,
  "data": {
    "trades": [
      {
        "tradeId": "b40e7c12-3a86-4d95-8f01-6e2c9a5d7031",
        "orderBookId": "clx_ob_comm_001",
        "takerOrderBookId": "clx_ob_comm_055",
        "origin": "CLOB",
        "makerAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
        "takerAddress": "0x9f8c1d4b2e7a3056c1b8f4d29e0a7c3518b6d24f",
        "price": "2410000000",
        "quantity": "2000000",
        "makerFee": "400",
        "takerFee": "1600",
        "side": "SELL",
        "settlementId": "clx_settle_92",
        "settlementStatus": "CONFIRMED",
        "settlementError": null,
        "createdAt": "2025-06-15T12:02:00.000Z",
        "orderBook": { "id": "clx_ob_comm_001", "symbol": "XAUA" }
      }
    ],
    "total": 1,
    "limit": 50,
    "offset": 0
  }
}

Overview

MiCA Register

Customers

Stock Tokenization

Stock Trading

External Securities Trading

Commodity Trading

Stock Lending

External Securities Lending

Vaults

Get User Trades

Path Parameters

Query Parameters

Response Fields

Error Codes

​Path Parameters

​Query Parameters

​Response Fields

​Error Codes

Path Parameters

Query Parameters

Response Fields

Error Codes