Trusset Protocol - Infrastructure for Asset Tokenization

POST

orderbooks

stocks

api

rfq

{id}

cancel

curl -X POST "https://api.trusset.org/orderbooks/stocks/api/rfq/clx_rfq_0091/cancel" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "requesterAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3" }'

const res = await fetch(
  `https://api.trusset.org/orderbooks/stocks/api/rfq/${rfqId}/cancel`,
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'trusset_your_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ requesterAddress: await wallet.getAddress() })
  }
);
const { data } = await res.json();

{
  "success": true,
  "data": {
    "id": "clx_rfq_0091",
    "requesterAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
    "side": "BUY",
    "baseAmount": "250000000",
    "status": "CANCELLED",
    "expiresAt": "2025-06-15T12:00:30.000Z",
    "updatedAt": "2025-06-15T12:00:19.000Z",
    "quotes": [
      {
        "id": "clx_quote_441",
        "lpAddress": "0x9f8c1d4b2e7a3056c1b8f4d29e0a7c3518b6d24f",
        "price": "182410000",
        "status": "WITHDRAWN",
        "validUntil": "2025-06-15T12:00:28.000Z"
      }
    ]
  }
}

{
  "success": false,
  "data": null,
  "error": {
    "code": "FORBIDDEN",
    "message": "Only the requester can cancel the RFQ"
  }
}

Cancels an RFQ you opened. Only the original requesterAddress may cancel. Cancelling withdraws every live quote and releases the funds each provider had committed, so it is the courteous way to close a request you no longer want rather than letting it expire. Providers get their inventory back immediately instead of at the next sweep. An RFQ that is already ACCEPTED, CANCELLED or EXPIRED is returned unchanged. The call succeeds, so a retry is safe.

Idempotency

Accepts an optional Idempotency-Key header.

Path Parameters

string

required

RFQ ID.

Body Parameters

string

required

Must equal the RFQ’s requesterAddress.

Response Fields

Returns the RFQ with its quotes, in the same shape as Get RFQ. Live quotes now read WITHDRAWN.

Releasing a provider’s committed funds is a custody operation. Where that release needs a signature that is not available, the release is retried by the balance lock reconciler rather than failing the cancel: the RFQ is cancelled either way.

curl -X POST "https://api.trusset.org/orderbooks/stocks/api/rfq/clx_rfq_0091/cancel" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "requesterAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3" }'

const res = await fetch(
  `https://api.trusset.org/orderbooks/stocks/api/rfq/${rfqId}/cancel`,
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'trusset_your_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ requesterAddress: await wallet.getAddress() })
  }
);
const { data } = await res.json();

{
  "success": true,
  "data": {
    "id": "clx_rfq_0091",
    "requesterAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
    "side": "BUY",
    "baseAmount": "250000000",
    "status": "CANCELLED",
    "expiresAt": "2025-06-15T12:00:30.000Z",
    "updatedAt": "2025-06-15T12:00:19.000Z",
    "quotes": [
      {
        "id": "clx_quote_441",
        "lpAddress": "0x9f8c1d4b2e7a3056c1b8f4d29e0a7c3518b6d24f",
        "price": "182410000",
        "status": "WITHDRAWN",
        "validUntil": "2025-06-15T12:00:28.000Z"
      }
    ]
  }
}

{
  "success": false,
  "data": null,
  "error": {
    "code": "FORBIDDEN",
    "message": "Only the requester can cancel the RFQ"
  }
}

Error Codes

Code	HTTP	Cause
`VALIDATION_ERROR`	`400`	`requesterAddress` is missing or not an address
`INVALID_PARAM`	`400`	`id` is missing or longer than 100 characters
`FORBIDDEN`	`403`	The caller is not the RFQ’s requester
`NOT_FOUND`	`404`	No RFQ with that ID on your 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/clx_rfq_0091/cancel" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "requesterAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3" }'

const res = await fetch(
  `https://api.trusset.org/orderbooks/stocks/api/rfq/${rfqId}/cancel`,
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'trusset_your_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ requesterAddress: await wallet.getAddress() })
  }
);
const { data } = await res.json();

{
  "success": true,
  "data": {
    "id": "clx_rfq_0091",
    "requesterAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
    "side": "BUY",
    "baseAmount": "250000000",
    "status": "CANCELLED",
    "expiresAt": "2025-06-15T12:00:30.000Z",
    "updatedAt": "2025-06-15T12:00:19.000Z",
    "quotes": [
      {
        "id": "clx_quote_441",
        "lpAddress": "0x9f8c1d4b2e7a3056c1b8f4d29e0a7c3518b6d24f",
        "price": "182410000",
        "status": "WITHDRAWN",
        "validUntil": "2025-06-15T12:00:28.000Z"
      }
    ]
  }
}

{
  "success": false,
  "data": null,
  "error": {
    "code": "FORBIDDEN",
    "message": "Only the requester can cancel the RFQ"
  }
}

Overview

MiCA Register

Customers

Tokenization

Trading

Lending

Asset Register

Vaults

Cancel RFQ

Idempotency

Path Parameters

Body Parameters

Response Fields

Error Codes

​Idempotency

​Path Parameters

​Body Parameters

​Response Fields

​Error Codes

Idempotency

Path Parameters

Body Parameters

Response Fields

Error Codes