Trusset Protocol - Infrastructure for Asset Tokenization

POST

orderbooks

commodities

api

imports

curl -X POST "https://api.trusset.org/orderbooks/commodities/api/imports" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "orderBookId": "clx_ob_comm_055" }'

const res = await fetch(
  'https://api.trusset.org/orderbooks/commodities/api/imports',
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'trusset_your_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ orderBookId: 'clx_ob_comm_055' })
  }
);
const { data } = await res.json();

{
  "success": true,
  "data": {
    "id": "clx_import_031",
    "instanceId": "inst_abc123",
    "orderBookId": "clx_ob_comm_055",
    "active": true,
    "createdAt": "2025-06-15T12:00:00.000Z",
    "updatedAt": "2025-06-15T12:00:00.000Z"
  }
}

Imports a book another instance published, so your instance can read and route flow to it. The owner keeps configuration control: you cannot pause it, reprice it, or change its fees. Re-importing a book you previously removed reactivates the existing link rather than creating a second one.

Body Parameters

string

required

ID of the book to import, from List Importable Order Books. Up to 100 characters.

Response Fields

Returns 201 with the import record.

object

Show child attributes

string

Import ID. Pass it to Remove Import.

string

Your instance.

string

The imported book.

boolean

true.

string

ISO 8601 timestamp.

string

ISO 8601 timestamp.

Importing does not put the two books in the same fungibility class. Pooling still requires both books to derive the same class from their attestations and both to have allowSharedLiquidity set.

curl -X POST "https://api.trusset.org/orderbooks/commodities/api/imports" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "orderBookId": "clx_ob_comm_055" }'

const res = await fetch(
  'https://api.trusset.org/orderbooks/commodities/api/imports',
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'trusset_your_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ orderBookId: 'clx_ob_comm_055' })
  }
);
const { data } = await res.json();

{
  "success": true,
  "data": {
    "id": "clx_import_031",
    "instanceId": "inst_abc123",
    "orderBookId": "clx_ob_comm_055",
    "active": true,
    "createdAt": "2025-06-15T12:00:00.000Z",
    "updatedAt": "2025-06-15T12:00:00.000Z"
  }
}

Error Codes

Code	HTTP	Cause
`VALIDATION_ERROR`	`400`	`orderBookId` is missing or malformed
`IMPORT_OWN`	`400`	The book already belongs to your instance
`IMPORT_TYPE_MISMATCH`	`400`	The book is not a commodity book. Use the venue that matches its token type
`NETWORK_MISMATCH`	`400`	The owning instance runs on a different network
`IMPORT_NOT_ALLOWED`	`403`	The book has `allowImport` off, or does not settle on-chain
`ORDER_BOOK_NOT_FOUND`	`404`	No book with that ID
`ALREADY_IMPORTED`	`409`	An active import already links this book to your instance
`SERVICE_NOT_ENABLED`	`403`	The Trading service is not enabled on this instance

curl -X POST "https://api.trusset.org/orderbooks/commodities/api/imports" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "orderBookId": "clx_ob_comm_055" }'

const res = await fetch(
  'https://api.trusset.org/orderbooks/commodities/api/imports',
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'trusset_your_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ orderBookId: 'clx_ob_comm_055' })
  }
);
const { data } = await res.json();

{
  "success": true,
  "data": {
    "id": "clx_import_031",
    "instanceId": "inst_abc123",
    "orderBookId": "clx_ob_comm_055",
    "active": true,
    "createdAt": "2025-06-15T12:00:00.000Z",
    "updatedAt": "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

Import Order Book

Body Parameters

Response Fields

Error Codes

​Body Parameters

​Response Fields

​Error Codes

Body Parameters

Response Fields

Error Codes