跳转至

获取业务线下订单

请求

GET https://api.mycactus.dev/custody/v1/api/projects/{b_id}/orders
GET https://api.mycactus.com/custody/v1/api/projects/{b_id}/orders

参数

路径参数

字段类型描述
b_id
必填
String业务线ID

查询参数

字段类型描述
start_time
可选
Integer起始过滤时间戳
end_time
可选
Integer结束过滤时间戳
keyword
可选
String关键字(订单ID、账户ID、钱包名称、钱包ID、订单描述、来源地址和目标地址)
limit
可选
Integer默认为10
offset
可选
Integer默认为0
sort_by_time
可选
String按时间序列排序 (默认为DESC)
applicant
可选
String[]制单人
coin_name
可选
String[]币种名称
允许值:参考支持的代币中的 Coin Name (API) 列
chain_name
可选
String[]Cactus链名称
允许值:参考支持的代币中的网络缩写 列
status
可选
String[]订单状态
wallet_name
可选
String[]钱包名称

响应

响应体

字段类型描述
codeInteger响应代码(0 = 成功)
messageString响应消息
successfulBoolean请求是否成功
dataObject订单数据(详见下方 data 对象详情)

data (对象)

字段类型描述
offsetInteger偏移量
limitInteger限制条数
totalInteger记录总数
listObject[]订单列表(详见下方 list 对象详情)

list (对象)

字段类型描述
domain_idString企业ID
bidString业务线ID
exchange_rateDecimal订单汇率
exchange_rate_strString订单汇率(字符串格式)
main_wallet_codeString主钱包ID
typeString订单提交类型
允许值: API, API_ETH_COLD_CONTRACT_WITHDRAW, API_TRON_COLD_CONTRACT_WITHDRAW, API_PRIME_NFT_TRANSFER
time_stampLong订单创建时间戳
order_noString订单ID
serial_noString订单序列号
applicantString订单制单人
business_nameString业务线名称
coin_nameString资产名称
full_nameString资产全称(例如 Tether USD)
storage_typeString存储类型
允许值: PRIME_HOT, PRIME_COLD, ENTERPRISE_HOT, ENTERPRISE_COLD
wallet_typeString钱包类型
允许值: MIXED_ADDRESS, SEGREGATED_ADDRESS, DAPP_ADDRESS, DAPP_CUSTOM_ADDRESS
connect_typeStringDeFi 使用的链(适用于 DeFi 订单)
wallet_nameString钱包名称
wallet_codeString钱包ID
amountDecimal提币金额
amount_strString提币金额(字符串格式)
original_amountDecimal原始提币金额
original_amount_strString原始提币金额(字符串格式)
miner_feeDecimal矿工费
miner_fee_strString矿工费(字符串格式)
miner_fee_rateDecimal矿工费率
miner_fee_rate_strString矿工费率(字符串格式)
descriptionString订单描述
from_addressString来源地址
gas_priceDecimalGas价格(ETH系列)
gas_price_strStringGas价格(ETH系列)(字符串格式)
max_fee_per_gasDecimal最大费用
max_fee_per_gas_strString最大费用(字符串格式)
max_priority_fee_per_gasDecimal优先费用
max_priority_fee_per_gas_strString优先费用(字符串格式)
gas_limitDecimalGas限制(ETH系列)
gas_limit_strStringGas限制(ETH系列)(字符串格式)
order_dest_address_info_vo_listObject[]订单列表(详见下方 order_dest_address_info_vo_list 对象详情)
chainString链名称
main_coinString主链资产(例如 TRX, ETH)
statusString订单状态
允许值: PROCESSING, PARTIALLY_FAILED, FAILED, ORDER_SEND_OUT, FINISHED, CANCELED
inner_statusString订单内部状态

order_dest_address_info_vo_list (对象)

字段类型描述
canceledBoolean该订单项是否已取消
item_statusString该订单项的状态(按目标地址)
dest_addressString收款地址
origin_balanceDecimal原始提币金额
origin_balance_strString原始提币金额(字符串格式)
balanceDecimal实际提币金额
balance_strString实际提币金额(字符串格式)
remarkString备注
memo_typeString备注类型
允许值: MEMO_NONE, MEMO_TEXT, MEMO_HASH
memoString备注
commentString评论

响应示例

{
  "code": 0,
  "message": "",
  "data": {
    "offset": 0,
    "limit": 10,
    "list": [
      {
        "domain_id": "1e2fa188f5d44faca64c45485062e867",
        "exchange_rate": 1.001,
        "exchange_rate_str": "1.00100000",
        "main_wallet_code": "CHTRON5526471567",
        "type": "API",
        "time_stamp": 1760339667000,
        "order_no": "TESTAPP_003",
        "serial_no": "GVB1TESTAPP_003",
        "applicant": "test@abc.com",
        "business_name": "FOR API TEST",
        "coin_name": "USDTTRC",
        "full_name": "Tether USD",
        "storage_type": "PRIME_HOT",
        "wallet_type": "MIXED_ADDRESS",
        "connect_type": null,
        "wallet_name": "",
        "wallet_code": "CHTRON5526471577",
        "amount": 11000000,
        "amount_str": "11000000",
        "original_amount": 11000000,
        "original_amount_str": "11000000",
        "miner_fee": 1805200,
        "miner_fee_str": "1805200",
        "miner_fee_rate": null,
        "miner_fee_rate_str": null,
        "description": "",
        "from_address": "",
        "gas_price": 100,
        "gas_price_str": "100",
        "max_fee_per_gas": null,
        "max_fee_per_gas_str": null,
        "max_priority_fee_per_gas": null,
        "max_priority_fee_per_gas_str": null,
        "gas_limit": null,
        "gas_limit_str": null,
        "order_dest_address_info_vo_list": [
          {
            "canceled": false,
            "item_status": "SUCCEEDED",
            "dest_address": "TLBGbH11Ei8xo7rnJCRT9GeukrDeACkumD",
            "origin_balance": 11000000,
            "origin_balance_str": "11000000",
            "balance": 11000000,
            "balance_str": "11000000",
            "remark": "test order item",
            "memo_type": "",
            "memo": "",
            "comment": ""
          }
        ],
        "chain": "TRON",
        "main_coin": "TRX",
        "status": "FINISHED",
        "inner_status": "FINISHED",
        "bid": "b4a25892d06542ba8fedb40e99d0c659"
      },
      {
        "domain_id": "1e2fa188f5d44faca64c45485062e867",
        "exchange_rate": 1.001,
        "exchange_rate_str": "1.00100000",
        "main_wallet_code": "CHTRON5526471567",
        "type": "API",
        "time_stamp": 1760339449000,
        "order_no": "TESTAPP_002",
        "serial_no": "LREXTESTAPP_002",
        "applicant": "test@abc.com",
        "business_name": "FOR API TEST",
        "coin_name": "USDTTRC",
        "full_name": "Tether USD",
        "storage_type": "PRIME_HOT",
        "wallet_type": "MIXED_ADDRESS",
        "connect_type": null,
        "wallet_name": "",
        "wallet_code": "CHTRON5526471577",
        "amount": 11,
        "amount_str": "11",
        "original_amount": 11,
        "original_amount_str": "11",
        "miner_fee": 2960200,
        "miner_fee_str": "2960200",
        "miner_fee_rate": null,
        "miner_fee_rate_str": null,
        "description": "",
        "from_address": "",
        "gas_price": 100,
        "gas_price_str": "100",
        "max_fee_per_gas": null,
        "max_fee_per_gas_str": null,
        "max_priority_fee_per_gas": null,
        "max_priority_fee_per_gas_str": null,
        "gas_limit": null,
        "gas_limit_str": null,
        "order_dest_address_info_vo_list": [
          {
            "canceled": false,
            "item_status": "SUCCEEDED",
            "dest_address": "TLBGbH11Ei8xo7rnJCRT9GeukrDeACkumD",
            "origin_balance": 11,
            "origin_balance_str": "11",
            "balance": 11,
            "balance_str": "11",
            "remark": "test order item",
            "memo_type": "",
            "memo": "",
            "comment": ""
          }
        ],
        "chain": "TRON",
        "main_coin": "TRX",
        "status": "FINISHED",
        "inner_status": "FINISHED",
        "bid": "b4a25892d06542ba8fedb40e99d0c667"
      }
    ],
    "total": 2
  },
  "successful": true
}