Trusset Protocol - Infrastructure for Asset Tokenization

GET

orderbooks

stocks

api

users

{userAddress}

trades

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

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

for (const t of data.trades) {
  const role = t.makerAddress === address.toLowerCase() ? 'maker' : 'taker';
  console.log(role, t.price, t.quantity, t.settlementStatus);
}

{
  "success": true,
  "data": {
    "trades": [
      {
        "tradeId": "1c9e0f22-2b74-4a51-9f8e-73c1a0d4b6e5",
        "orderBookId": "clx_ob_stock_002",
        "takerOrderBookId": null,
        "origin": "CLOB",
        "makerAddress": "0x9f8c1d4b2e7a3056c1b8f4d29e0a7c3518b6d24f",
        "takerAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
        "price": "182350000",
        "quantity": "1000000",
        "makerFee": "500",
        "takerFee": "1500",
        "side": "BUY",
        "settlementId": "clx_settle_51",
        "settlementStatus": "CONFIRMED",
        "settlementError": null,
        "quoteId": null,
        "createdAt": "2025-06-15T12:02:00.000Z",
        "orderBook": { "id": "clx_ob_stock_002", "symbol": "NYF1" }
      }
    ],
    "total": 1,
    "limit": 50,
    "offset": 0
  }
}

Returns trades where the wallet was maker or taker, newest first, across every stock book your instance owns or has imported. Trades that originated from a request for quote on your instance are included even when they carry no book, since an RFQ trade can stand alone. The scope follows shared liquidity: a fill against a pooled peer book appears here because the 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, or null on a standalone RFQ trade.

string

Taker’s book when the fill crossed a pooled peer, otherwise null.

string

CLOB, RFQ or AUCTION.

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, AWAITING_SIGNATURE, or null where the book stages no settlement.

string

Why settlement failed, or null.

string

Accepted RFQ quote, or null.

string

ISO 8601 timestamp.

object

The maker’s book record, or null.

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/stocks/api/users/0xabc7f1093d5e26b804a1c3f78de025916b47c0d3/trades?limit=50" \
  -H "X-API-Key: trusset_your_key_here"

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

for (const t of data.trades) {
  const role = t.makerAddress === address.toLowerCase() ? 'maker' : 'taker';
  console.log(role, t.price, t.quantity, t.settlementStatus);
}

{
  "success": true,
  "data": {
    "trades": [
      {
        "tradeId": "1c9e0f22-2b74-4a51-9f8e-73c1a0d4b6e5",
        "orderBookId": "clx_ob_stock_002",
        "takerOrderBookId": null,
        "origin": "CLOB",
        "makerAddress": "0x9f8c1d4b2e7a3056c1b8f4d29e0a7c3518b6d24f",
        "takerAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
        "price": "182350000",
        "quantity": "1000000",
        "makerFee": "500",
        "takerFee": "1500",
        "side": "BUY",
        "settlementId": "clx_settle_51",
        "settlementStatus": "CONFIRMED",
        "settlementError": null,
        "quoteId": null,
        "createdAt": "2025-06-15T12:02:00.000Z",
        "orderBook": { "id": "clx_ob_stock_002", "symbol": "NYF1" }
      }
    ],
    "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/stocks/api/users/0xabc7f1093d5e26b804a1c3f78de025916b47c0d3/trades?limit=50" \
  -H "X-API-Key: trusset_your_key_here"

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

for (const t of data.trades) {
  const role = t.makerAddress === address.toLowerCase() ? 'maker' : 'taker';
  console.log(role, t.price, t.quantity, t.settlementStatus);
}

{
  "success": true,
  "data": {
    "trades": [
      {
        "tradeId": "1c9e0f22-2b74-4a51-9f8e-73c1a0d4b6e5",
        "orderBookId": "clx_ob_stock_002",
        "takerOrderBookId": null,
        "origin": "CLOB",
        "makerAddress": "0x9f8c1d4b2e7a3056c1b8f4d29e0a7c3518b6d24f",
        "takerAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
        "price": "182350000",
        "quantity": "1000000",
        "makerFee": "500",
        "takerFee": "1500",
        "side": "BUY",
        "settlementId": "clx_settle_51",
        "settlementStatus": "CONFIRMED",
        "settlementError": null,
        "quoteId": null,
        "createdAt": "2025-06-15T12:02:00.000Z",
        "orderBook": { "id": "clx_ob_stock_002", "symbol": "NYF1" }
      }
    ],
    "total": 1,
    "limit": 50,
    "offset": 0
  }
}

Overview

MiCA Register

Customers

Tokenization

Trading

Lending

Asset Register

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