Skip to content

Get Quote From OTC Vendor

Endpoint

POST https://api.mycactus.dev/custody/v1/api/otc/order/quote
POST https://api.mycactus.com/custody/v1/api/otc/order/quote

Parameters

Body Parameters

FieldTypeDescription
b_id
Required
StringBusiness line ID
base_asset
Required
StringBase asset symbol
quote_asset
Required
StringQuote asset symbol
direction
Required
StringTrade directions.
Allowed values: BUY, SELL
otc_entity_enum
Required
StringOTC vendor name (currently only supports FLYWING)

quote_enum

Required

String

Allowed values:

  • Quotation mode: QUOTATION.
  • Order Mode (will validate the corresponding wallet): ORDER

chain

Required

String

Blockchain network for sending to OTC vendor.
Current supported values:

  • ERC20 - Ethereum Mainnet
  • TRC20 - Tron Network

client_chain

Required

String

Blockchain network for OTC vendor to send to client.

Current supported values:

  • ERC20 - Ethereum Mainnet
  • TRC20 - Tron Network
payment_amount
Optional
StringPayment amount (either payment_amount or receive_amount required)
receive_amount
Optional
StringReceive amount (either payment_amount or receive_amount required)
payment_address
Optional
StringRequired for ORDER mode, ignored if currency is USD
receive_address
Optional
StringRequired for ORDER mode, ignored if currency is USD
payment_wallet_code
Optional
StringRequired for ORDER mode, ignored if currency is USD
receive_wallet_code
Optional
StringRequired for ORDER mode, ignored if currency is USD
check_price
Optional
BooleanWhether to check trading pair exchange rate deviation
Default value: false

Request Body Example

{
  "b_id": "a4e0db8585dc49ac8ec916e097000000",
  "base_asset": "TRX",
  "quote_asset": "USD",
  "otc_entity_enum": "FLYWING",
  "quote_enum": "ORDER",
  "chain": "TRC20",
  "client_chain": "USD",
  "payment_amount": "",
  "receive_amount": "2",
  "payment_address": "TLabC1CpcU1PHY0a03irPKQjfTYx1kkbjM",
  "receive_address": "",
  "payment_wallet_code": "CHTRON1882030000",
  "receive_wallet_code": ""
}

Response

Response Body

FieldTypeDescription
codeIntegerResponse code (0 = success)
messageStringResponse message
successfulBooleanWhether the request was successful
dataObjectQuote data (see data object details below)

data (object)

FieldTypeDescription
quantityNumberQuantity of base asset
exchange_rateNumberExchange rate applied
base_assetStringBase asset symbol
final_priceNumberFinal price per unit
market_priceNumberCurrent market price per unit
settlement_amountNumberSettlement amount
quote_assetStringQuote asset symbol
client_nameStringClient name
directionStringTrade direction.
Allowed values: BUY, SELL
effective_limitNumberEffective limit amount (for quote asset)
rfq_expirationStringRequest For Quote expiration time (format: yyyy-MM-dd HH:mm:ss)
current_utilizationNumberCurrent credit utilization (percentage)
min_trading_size_base_assetNumberMinimum tradable size (in base asset)
rfqstatusStringRFQ status (e.g., INDICATIVE_PRICE)
max_trading_size_base_assetNumberMaximum tradable size (for base asset)
min_trading_size_quote_assetNumberMinimum tradable size (for quote asset)
available_creditNumberAvailable credit balance (for quote asset)
max_trading_size_quote_assetNumberMaximum tradable size (for quote asset)
timestampStringQuote generation timestamp (format: yyyy-MM-dd HH:mm:ss)

Response Example

{
  "code": 0,
  "data": {
    "effective_limit": 2.464,
    "quantity": 8.116883,
    "exchange_rate": 0.2464,
    "rfq_expiration": "2025-04-28 15:56:41",
    "current_utilization": 50.03,
    "min_trading_size_base_asset": 1,
    "rfqstatus": "INDICATIVE_PRICE",
    "base_asset": "TRX",
    "final_price": 0.2464,
    "max_trading_size_base_asset": 10,
    "market_price": 0.2469,
    "settlement_amount": 2,
    "min_trading_size_quote_asset": 0.2464,
    "quote_asset": "USD",
    "client_name": "Daniel Test Ltd",
    "available_credit": 99949.97,
    "direction": "SELL",
    "max_trading_size_quote_asset": 2.464,
    "timestamp": "2025-04-28 15:56:36"
  },
  "message": "",
  "successful": true
}