Trusset Protocol - Infrastructure for Asset Tokenization

POST

orderbooks

stocks

api

rfq

curl -X POST "https://api.trusset.org/orderbooks/stocks/api/rfq" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: rfq-2025-06-15-0001" \
  -d '{
    "requesterAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
    "baseToken": "0x51f2b9d0e77c4a1b83ce6d4a9271e5f3a0c8b912",
    "quoteToken": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
    "custodyContract": "0x98c33b10823172e62a31d6048773df1054c4f821",
    "side": "BUY",
    "baseAmount": "250000000",
    "expiryMs": 30000
  }'

const res = await fetch(
  'https://api.trusset.org/orderbooks/stocks/api/rfq',
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'trusset_your_key_here',
      'Content-Type': 'application/json',
      'Idempotency-Key': crypto.randomUUID()
    },
    body: JSON.stringify({
      requesterAddress: await wallet.getAddress(),
      baseToken,
      quoteToken,
      custodyContract,
      side: 'BUY',
      baseAmount: '250000000'
    })
  }
);
const { data } = await res.json();
// poll GET /rfq/{id}/quotes until expiresAt

{
  "success": true,
  "data": {
    "id": "clx_rfq_0091",
    "instanceId": "inst_abc123",
    "requesterAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
    "baseToken": "0x51f2b9d0e77c4a1b83ce6d4a9271e5f3a0c8b912",
    "quoteToken": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
    "custodyContract": "0x98c33b10823172e62a31d6048773df1054c4f821",
    "side": "BUY",
    "baseAmount": "250000000",
    "status": "PENDING",
    "expiresAt": "2025-06-15T12:00:30.000Z",
    "createdAt": "2025-06-15T12:00:00.000Z",
    "updatedAt": "2025-06-15T12:00:00.000Z"
  }
}

Opens a request for quote. Instead of resting on the book, you name a pair, a side and a size, and registered liquidity providers respond with executable prices. Use it for sizes the visible book cannot absorb without moving. An RFQ is addressed by custody contract and token pair, not by order book ID. Providers subscribed to that pair are notified immediately over the venue’s real-time channel. If a book exists on your instance for the same triple, its price reference is used to validate quotes. RFQs are short-lived by design: a quote is only executable while the provider’s funds are still committed to it.

Lifecycle

An RFQ starts PENDING. It becomes QUOTED when a provider responds, ACCEPTED when you take a quote, CANCELLED when you withdraw it, and EXPIRED when its deadline passes. A background sweeper runs every five seconds and expires stale requests and quotes, releasing the funds each had committed. Providers quote from the Trusset issuer application rather than through this API surface, and quoting is gated on a provider being configured to respond to RFQs.

Idempotency

Accepts an optional Idempotency-Key header. A repeat with the same key and body replays the original response rather than opening a second request.

Body Parameters

string

required

Wallet asking for the quote. Only this address may accept or cancel the resulting RFQ.

string

required

Token you want to buy or sell.

string

required

Settlement token (stablecoin).

string

required

Custody contract the trade would settle through. Together with the two token addresses this is what providers subscribe to.

string

required

BUY or SELL, from the requester’s point of view.

string

required

Size in order book units, as a digit-only string. Must be greater than zero.

integer

default:"30000"

How long the request stays open, in milliseconds. Clamped to between 5000 and 60000.

Response Fields

Returns 201.

object

Show child attributes

string

RFQ ID. Use it on every other RFQ endpoint.

string

Your instance.

string

Requesting wallet, lower-cased.

string

Base token, lower-cased.

string

Quote token, lower-cased.

string

Custody contract, lower-cased.

string

BUY or SELL.

string

Requested size in order book units.

string

PENDING.

string

ISO 8601 deadline.

string

ISO 8601 timestamp.

string

ISO 8601 timestamp.

curl -X POST "https://api.trusset.org/orderbooks/stocks/api/rfq" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: rfq-2025-06-15-0001" \
  -d '{
    "requesterAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
    "baseToken": "0x51f2b9d0e77c4a1b83ce6d4a9271e5f3a0c8b912",
    "quoteToken": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
    "custodyContract": "0x98c33b10823172e62a31d6048773df1054c4f821",
    "side": "BUY",
    "baseAmount": "250000000",
    "expiryMs": 30000
  }'

const res = await fetch(
  'https://api.trusset.org/orderbooks/stocks/api/rfq',
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'trusset_your_key_here',
      'Content-Type': 'application/json',
      'Idempotency-Key': crypto.randomUUID()
    },
    body: JSON.stringify({
      requesterAddress: await wallet.getAddress(),
      baseToken,
      quoteToken,
      custodyContract,
      side: 'BUY',
      baseAmount: '250000000'
    })
  }
);
const { data } = await res.json();
// poll GET /rfq/{id}/quotes until expiresAt

{
  "success": true,
  "data": {
    "id": "clx_rfq_0091",
    "instanceId": "inst_abc123",
    "requesterAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
    "baseToken": "0x51f2b9d0e77c4a1b83ce6d4a9271e5f3a0c8b912",
    "quoteToken": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
    "custodyContract": "0x98c33b10823172e62a31d6048773df1054c4f821",
    "side": "BUY",
    "baseAmount": "250000000",
    "status": "PENDING",
    "expiresAt": "2025-06-15T12:00:30.000Z",
    "createdAt": "2025-06-15T12:00:00.000Z",
    "updatedAt": "2025-06-15T12:00:00.000Z"
  }
}

Error Codes

Code	HTTP	Cause
`VALIDATION_ERROR`	`400`	A field failed schema validation
`INVALID_PARAM`	`400`	A required address is missing, `side` is not `BUY` or `SELL`, or `baseAmount` is not positive
`INSTANCE_REQUIRED`	`400`	The request carried no resolvable instance
`IDEMPOTENCY_MISMATCH`	`409`	The key was used before with a different body
`SERVICE_NOT_ENABLED`	`403`	The Trading service is not enabled on this instance

curl -X POST "https://api.trusset.org/orderbooks/stocks/api/rfq" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: rfq-2025-06-15-0001" \
  -d '{
    "requesterAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
    "baseToken": "0x51f2b9d0e77c4a1b83ce6d4a9271e5f3a0c8b912",
    "quoteToken": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
    "custodyContract": "0x98c33b10823172e62a31d6048773df1054c4f821",
    "side": "BUY",
    "baseAmount": "250000000",
    "expiryMs": 30000
  }'

const res = await fetch(
  'https://api.trusset.org/orderbooks/stocks/api/rfq',
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'trusset_your_key_here',
      'Content-Type': 'application/json',
      'Idempotency-Key': crypto.randomUUID()
    },
    body: JSON.stringify({
      requesterAddress: await wallet.getAddress(),
      baseToken,
      quoteToken,
      custodyContract,
      side: 'BUY',
      baseAmount: '250000000'
    })
  }
);
const { data } = await res.json();
// poll GET /rfq/{id}/quotes until expiresAt

{
  "success": true,
  "data": {
    "id": "clx_rfq_0091",
    "instanceId": "inst_abc123",
    "requesterAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
    "baseToken": "0x51f2b9d0e77c4a1b83ce6d4a9271e5f3a0c8b912",
    "quoteToken": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
    "custodyContract": "0x98c33b10823172e62a31d6048773df1054c4f821",
    "side": "BUY",
    "baseAmount": "250000000",
    "status": "PENDING",
    "expiresAt": "2025-06-15T12:00:30.000Z",
    "createdAt": "2025-06-15T12:00:00.000Z",
    "updatedAt": "2025-06-15T12:00:00.000Z"
  }
}

Overview

MiCA Register

Customers

Tokenization

Trading

Lending

Asset Register

Vaults

Create RFQ

Lifecycle

Idempotency

Body Parameters

Response Fields

Error Codes

​Lifecycle

​Idempotency

​Body Parameters

​Response Fields

​Error Codes

Lifecycle

Idempotency

Body Parameters

Response Fields

Error Codes