Trusset Protocol - Infrastructure for Asset Tokenization

GET

orderbooks

external-securities

api

settlements

pending

curl "https://api.trusset.org/orderbooks/external-securities/api/settlements/pending?limit=25" \
  -H "X-API-Key: trusset_your_key_here"

const res = await fetch(
  'https://api.trusset.org/orderbooks/external-securities/api/settlements/pending',
  { headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();

for (const s of data.settlements) {
  const cd = await fetch(
    `https://api.trusset.org/orderbooks/external-securities/api/settlements/${s.settlementId}/calldata`,
    { headers: { 'X-API-Key': 'trusset_your_key_here' } }
  ).then(r => r.json());

  if (!cd.data.transaction) continue;
  const tx = await operator.sendTransaction(cd.data.transaction);
  await tx.wait();
  // then confirm with tx.hash
}

{
  "success": true,
  "data": {
    "settlements": [
      {
        "settlementId": "0f7c2a19-64b8-4d02-9e51-73ab0c5d6f18",
        "status": "PENDING",
        "createdAt": "2025-06-15T12:00:01.000Z",
        "error": null,
        "trades": [
          {
            "tradeId": "5b3c19e0-7a42-4d86-91f5-2c0e8d47b613",
            "orderBookId": "clx_ob_extsec_001",
            "takerOrderBookId": null,
            "price": "104200000",
            "quantity": "10000000",
            "makerAddress": "0x9f8c1d4b2e7a3056c1b8f4d29e0a7c3518b6d24f",
            "takerAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
            "settlementStatus": "AWAITING_SIGNATURE",
            "settlementError": null,
            "createdAt": "2025-06-15T12:00:00.000Z"
          }
        ]
      }
    ]
  }
}

Returns the settlements on your instance that still need a signature, oldest first. This is the operator’s work list: everything here is actionable, and everything actionable is here. Scope is deliberately tight. Only settlements whose trades sit on external securities books appear, because a settlement from another book family would dead-end on the calldata route with nothing an operator could do about it. Settlements already CONFIRMED or FAILED are excluded: a failed settlement is terminal, its trades are reversed and its reservations released, so it is finished work rather than outstanding work. It stays readable through Get Settlement. Within each settlement, trades that are individually confirmed or failed are filtered out, so trades lists only what the next transaction would cover.

Query Parameters

string

Restrict to settlements touching one book, as maker’s or taker’s side.

integer

default:"25"

Maximum settlements to return. Capped at 25.

Response Fields

object

Show child attributes

array

Show child attributes

string

Settlement ID. Pass it to the calldata and confirm endpoints.

string

PENDING or PROCESSING.

string

ISO 8601 timestamp.

string

The last build failure recorded, or null. A settlement can carry an error and still be pending, when the failure was transient.

array

Show child attributes

string

Trade ID.

string

Maker’s book.

string

Taker’s book, or null.

string

Execution price in order book units.

string

Base quantity in order book units.

string

Seller or resting side.

string

Aggressing side.

string

AWAITING_SIGNATURE, or PROCESSING.

string

Per-trade failure reason, or null.

string

ISO 8601 timestamp.

Fetch the transaction for each entry with Get Settlement Calldata rather than reusing a payload from an earlier response. The calldata is rebuilt against current chain state and the book’s current settlement operator each time it is requested.

curl "https://api.trusset.org/orderbooks/external-securities/api/settlements/pending?limit=25" \
  -H "X-API-Key: trusset_your_key_here"

const res = await fetch(
  'https://api.trusset.org/orderbooks/external-securities/api/settlements/pending',
  { headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();

for (const s of data.settlements) {
  const cd = await fetch(
    `https://api.trusset.org/orderbooks/external-securities/api/settlements/${s.settlementId}/calldata`,
    { headers: { 'X-API-Key': 'trusset_your_key_here' } }
  ).then(r => r.json());

  if (!cd.data.transaction) continue;
  const tx = await operator.sendTransaction(cd.data.transaction);
  await tx.wait();
  // then confirm with tx.hash
}

{
  "success": true,
  "data": {
    "settlements": [
      {
        "settlementId": "0f7c2a19-64b8-4d02-9e51-73ab0c5d6f18",
        "status": "PENDING",
        "createdAt": "2025-06-15T12:00:01.000Z",
        "error": null,
        "trades": [
          {
            "tradeId": "5b3c19e0-7a42-4d86-91f5-2c0e8d47b613",
            "orderBookId": "clx_ob_extsec_001",
            "takerOrderBookId": null,
            "price": "104200000",
            "quantity": "10000000",
            "makerAddress": "0x9f8c1d4b2e7a3056c1b8f4d29e0a7c3518b6d24f",
            "takerAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
            "settlementStatus": "AWAITING_SIGNATURE",
            "settlementError": null,
            "createdAt": "2025-06-15T12:00:00.000Z"
          }
        ]
      }
    ]
  }
}

Error Codes

Code	HTTP	Cause
`SERVICE_NOT_ENABLED`	`403`	The Trading service is not enabled on this instance

curl "https://api.trusset.org/orderbooks/external-securities/api/settlements/pending?limit=25" \
  -H "X-API-Key: trusset_your_key_here"

const res = await fetch(
  'https://api.trusset.org/orderbooks/external-securities/api/settlements/pending',
  { headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();

for (const s of data.settlements) {
  const cd = await fetch(
    `https://api.trusset.org/orderbooks/external-securities/api/settlements/${s.settlementId}/calldata`,
    { headers: { 'X-API-Key': 'trusset_your_key_here' } }
  ).then(r => r.json());

  if (!cd.data.transaction) continue;
  const tx = await operator.sendTransaction(cd.data.transaction);
  await tx.wait();
  // then confirm with tx.hash
}

{
  "success": true,
  "data": {
    "settlements": [
      {
        "settlementId": "0f7c2a19-64b8-4d02-9e51-73ab0c5d6f18",
        "status": "PENDING",
        "createdAt": "2025-06-15T12:00:01.000Z",
        "error": null,
        "trades": [
          {
            "tradeId": "5b3c19e0-7a42-4d86-91f5-2c0e8d47b613",
            "orderBookId": "clx_ob_extsec_001",
            "takerOrderBookId": null,
            "price": "104200000",
            "quantity": "10000000",
            "makerAddress": "0x9f8c1d4b2e7a3056c1b8f4d29e0a7c3518b6d24f",
            "takerAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
            "settlementStatus": "AWAITING_SIGNATURE",
            "settlementError": null,
            "createdAt": "2025-06-15T12:00:00.000Z"
          }
        ]
      }
    ]
  }
}

Overview

MiCA Register

Customers

Stock Tokenization

Stock Trading

External Securities Trading

Commodity Trading

Stock Lending

External Securities Lending

Vaults

List Pending Settlements

Query Parameters

Response Fields

Error Codes

​Query Parameters

​Response Fields

​Error Codes

Query Parameters

Response Fields

Error Codes