Skip to content

Create OTC Order

Endpoint

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

Parameters

Body Parameters

FieldTypeDescription
order_no
Required
StringOrder number
b_id
Required
StringBusiness line ID
project_name
Required
StringBusiness line name
direction
Required
StringTrade directions
Allowed values: BUY, SELL
base_asset
Required
StringBase asset symbol
quote_asset
Required
StringQuote asset symbol
otc_entity_enum
Required
StringOTC vendor name (currently only supports FLYWING)
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
Required
StringPayment amount
receive_amount
Required
StringReceive amount
payment_address
Required
StringPayment address (ignored if currency is USD)
receive_address
Required
StringReceive address (ignored if currency is USD)
payment_wallet_code
Required
StringPayment wallet code (ignored if currency is USD)
receive_wallet_code
Required
StringReceive wallet code (ignored if currency is USD)
final_price
Required
StringFinal exchange rate for the trading pair
market_price
Required
StringMarket exchange rate for the trading pair
check_price
Optional
BooleanWhether to check trading pair exchange rate deviation.
Default value: false

Request Body Example

{
  "order_no": "OTC2024061401000030",
  "b_id": "a4e0db8585dc49ac8ec916e097216031",
  "project_name": "otc-test",
  "direction": "BUY",
  "base_asset": "USDT",
  "quote_asset": "USD",
  "otc_entity_enum": "FLYWING",
  "chain": "USD",
  "client_chain": "TRC-20",
  "payment_amount": "6.01",
  "receive_amount": "6",
  "payment_address": "",
  "receive_address": "TLvdY8CpcU8PHY1y23irPKQjfTYx1kkbjM",
  "payment_wallet_code": "",
  "receive_wallet_code": "CHUSDTTRC6880475855",
  "final_price": "1.0018",
  "market_price": "1.0003"
}

Response

Response Body

FieldTypeDescription
codeIntegerResponse code (0 = success)
messageStringResponse message
successfulBooleanWhether the request was successful
dataObjectOrder creation result data

Response Example

{
  "code": 0,
  "data": {},
  "message": "",
  "successful": true
}