Trusset Protocol - Infrastructure for Asset Tokenization

POST

orderbooks

stocks

api

rfq

{
  "requesterAddress": "0x1111111111111111111111111111111111111111",
  "baseToken": "0x1234567890abcdef1234567890abcdef12345678",
  "quoteToken": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
  "custodyContract": "0x9876543210fedcba9876543210fedcba98765432",
  "side": "BUY",
  "baseAmount": "5000000000000000000",
  "expiryMs": 15000
}

{
  "success": true,
  "data": {
    "id": "rfq_abc123",
    "requesterAddress": "0x1111111111111111111111111111111111111111",
    "baseToken": "0x1234567890abcdef1234567890abcdef12345678",
    "quoteToken": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
    "custodyContract": "0x9876543210fedcba9876543210fedcba98765432",
    "side": "BUY",
    "baseAmount": "5000000000000000000",
    "status": "OPEN",
    "expiresAt": "2025-01-15T10:30:15.000Z",
    "createdAt": "2025-01-15T10:30:00.000Z"
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-01-15T10:30:00.000Z",
    "instanceId": "inst_abc"
  }
}

Opens a request for quote (RFQ). The requester specifies a token pair, a side, and a base amount, and registered market makers respond with executable quotes. RFQs are short-lived: they expire after expiryMs (default applies if omitted), after which no further quotes or acceptances are accepted. Use List Quotes to retrieve the quotes received, then Accept Quote to execute against one.

Authentication

Requires an instance API key with the trading service enabled.

Idempotency

This endpoint accepts an optional Idempotency-Key header. Reusing a key with the same body returns the original RFQ; reusing it with a different body returns IDEMPOTENCY_MISMATCH.

Request Body

requesterAddress

string

required

EVM address of the requesting party. Must match 0x[a-fA-F0-9]{40}.

baseToken

string

required

EVM address of the base token (the asset being bought or sold). Must match 0x[a-fA-F0-9]{40}.

quoteToken

string

required

EVM address of the quote token (the currency used for pricing). Must match 0x[a-fA-F0-9]{40}.

custodyContract

string

required

EVM address of the custody contract that will escrow and settle the trade. Must match 0x[a-fA-F0-9]{40}.

side

string

required

The requester’s side. One of BUY or SELL.

baseAmount

string

required

Amount of the base token to trade, in base units (wei). Numeric string.

expiryMs

integer

Lifetime of the RFQ in milliseconds. 5000-60000. If omitted, the instance default applies.

{
  "requesterAddress": "0x1111111111111111111111111111111111111111",
  "baseToken": "0x1234567890abcdef1234567890abcdef12345678",
  "quoteToken": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
  "custodyContract": "0x9876543210fedcba9876543210fedcba98765432",
  "side": "BUY",
  "baseAmount": "5000000000000000000",
  "expiryMs": 15000
}

{
  "success": true,
  "data": {
    "id": "rfq_abc123",
    "requesterAddress": "0x1111111111111111111111111111111111111111",
    "baseToken": "0x1234567890abcdef1234567890abcdef12345678",
    "quoteToken": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
    "custodyContract": "0x9876543210fedcba9876543210fedcba98765432",
    "side": "BUY",
    "baseAmount": "5000000000000000000",
    "status": "OPEN",
    "expiresAt": "2025-01-15T10:30:15.000Z",
    "createdAt": "2025-01-15T10:30:00.000Z"
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-01-15T10:30:00.000Z",
    "instanceId": "inst_abc"
  }
}

Error Codes

Code	Status	Description
`INSUFFICIENT_CUSTODY_BALANCE`	400	The requester lacks sufficient custody balance for the trade
`MM_REQUIRED`	403	No eligible market maker is available for this pair
`MM_CONFIG_VIOLATION`	400	The request violates market maker configuration constraints
`IDEMPOTENCY_MISMATCH`	409	Idempotency key reused with a different request body
`VALIDATION_ERROR`	400	Request body failed schema validation

Get Auction

Get RFQ

{
  "requesterAddress": "0x1111111111111111111111111111111111111111",
  "baseToken": "0x1234567890abcdef1234567890abcdef12345678",
  "quoteToken": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
  "custodyContract": "0x9876543210fedcba9876543210fedcba98765432",
  "side": "BUY",
  "baseAmount": "5000000000000000000",
  "expiryMs": 15000
}

{
  "success": true,
  "data": {
    "id": "rfq_abc123",
    "requesterAddress": "0x1111111111111111111111111111111111111111",
    "baseToken": "0x1234567890abcdef1234567890abcdef12345678",
    "quoteToken": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
    "custodyContract": "0x9876543210fedcba9876543210fedcba98765432",
    "side": "BUY",
    "baseAmount": "5000000000000000000",
    "status": "OPEN",
    "expiresAt": "2025-01-15T10:30:15.000Z",
    "createdAt": "2025-01-15T10:30:00.000Z"
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-01-15T10:30:00.000Z",
    "instanceId": "inst_abc"
  }
}

Overview

MiCA Register

Customers

Stock Tokenization

Trading

Stock Lending

External Securities Lending

Create RFQ

Authentication

Idempotency

Request Body

Error Codes

​Authentication

​Idempotency

​Request Body

​Error Codes

Authentication

Idempotency

Request Body

Error Codes