curl --request GET \
--url 'https://api-sandbox.uqpaytech.com/api/v1/stocks/order/53fe3d55-85ff-4804-b6f0-a25a32aa082f' \
--header "Content-Type: application/json" \
--header "x-auth-token: Bearer ${SANDBOX_TOKEN}"
{
"transfer_quantity": null,
"order_id": "53fe3d55-85ff-4804-b6f0-a25a32aa082f",
"quote_id": "0576b03b-56dd-48b1-ba24-058ce90d0f53",
"client_reference": "stocks-docs-20260921-buy-01",
"asset_id": "7453f146-b267-11f1-b4f4-0abd773ba497",
"symbol": "AAPLx",
"side": "BUY",
"status": "SUCCESS",
"network": "Ethereum",
"funding_currency": "USDC",
"quoted_quantity": "0.00297066689243735",
"executed_quantity": "0.00297066689243735",
"executed_price": "336.624750000000055741",
"cash_amount": "1",
"fees": [
{
"type": "TRADING",
"amount": "0.0005",
"currency": "USDC"
}
],
"total_amount": "1.0005",
"transaction_hash": "0x7e7b7f06c0a4adce2ec2bc01b455fd4e014b9f298e7e2598b02c93dffa86a96f",
"failure_code": null,
"failure_message": null,
"created_at": "2026-09-21T01:33:08.629Z",
"updated_at": "2026-09-21T01:50:53.855Z",
"completed_at": "2026-09-21T01:50:53.561Z",
"failed_at": null
}
查询订单
查询订单的当前状态。HTTP 请求成功本身不表示订单已完成结算。
curl --request GET \
--url 'https://api-sandbox.uqpaytech.com/api/v1/stocks/order/53fe3d55-85ff-4804-b6f0-a25a32aa082f' \
--header "Content-Type: application/json" \
--header "x-auth-token: Bearer ${SANDBOX_TOKEN}"
{
"transfer_quantity": null,
"order_id": "53fe3d55-85ff-4804-b6f0-a25a32aa082f",
"quote_id": "0576b03b-56dd-48b1-ba24-058ce90d0f53",
"client_reference": "stocks-docs-20260921-buy-01",
"asset_id": "7453f146-b267-11f1-b4f4-0abd773ba497",
"symbol": "AAPLx",
"side": "BUY",
"status": "SUCCESS",
"network": "Ethereum",
"funding_currency": "USDC",
"quoted_quantity": "0.00297066689243735",
"executed_quantity": "0.00297066689243735",
"executed_price": "336.624750000000055741",
"cash_amount": "1",
"fees": [
{
"type": "TRADING",
"amount": "0.0005",
"currency": "USDC"
}
],
"total_amount": "1.0005",
"transaction_hash": "0x7e7b7f06c0a4adce2ec2bc01b455fd4e014b9f298e7e2598b02c93dffa86a96f",
"failure_code": null,
"failure_message": null,
"created_at": "2026-09-21T01:33:08.629Z",
"updated_at": "2026-09-21T01:50:53.855Z",
"completed_at": "2026-09-21T01:50:53.561Z",
"failed_at": null
}
curl --request GET \
--url 'https://api-sandbox.uqpaytech.com/api/v1/stocks/order/53fe3d55-85ff-4804-b6f0-a25a32aa082f' \
--header "Content-Type: application/json" \
--header "x-auth-token: Bearer ${SANDBOX_TOKEN}"
{
"transfer_quantity": null,
"order_id": "53fe3d55-85ff-4804-b6f0-a25a32aa082f",
"quote_id": "0576b03b-56dd-48b1-ba24-058ce90d0f53",
"client_reference": "stocks-docs-20260921-buy-01",
"asset_id": "7453f146-b267-11f1-b4f4-0abd773ba497",
"symbol": "AAPLx",
"side": "BUY",
"status": "SUCCESS",
"network": "Ethereum",
"funding_currency": "USDC",
"quoted_quantity": "0.00297066689243735",
"executed_quantity": "0.00297066689243735",
"executed_price": "336.624750000000055741",
"cash_amount": "1",
"fees": [
{
"type": "TRADING",
"amount": "0.0005",
"currency": "USDC"
}
],
"total_amount": "1.0005",
"transaction_hash": "0x7e7b7f06c0a4adce2ec2bc01b455fd4e014b9f298e7e2598b02c93dffa86a96f",
"failure_code": null,
"failure_message": null,
"created_at": "2026-09-21T01:33:08.629Z",
"updated_at": "2026-09-21T01:50:53.855Z",
"completed_at": "2026-09-21T01:50:53.561Z",
"failed_at": null
}
授权
由 UQPAY 提供的登录 API Token。
路径参数
创建或查询订单列表时返回的订单标识。
响应
成功
用于查询订单详情的订单标识。
"53fe3d55-85ff-4804-b6f0-a25a32aa082f"
交易订单使用的报价标识；充值和提现记录为 null。
"0576b03b-56dd-48b1-ba24-058ce90d0f53"
用于查询订单的客户参考号，不能替代幂等键。
"stocks-docs-20260921-buy-01"
平台资产 UUID，列表与所有交易接口共用
"7453f146-b267-11f1-b4f4-0abd773ba497"
资产代码。
"AAPLx"
订单业务类型。交易订单来源于报价；充值和提现记录表示资产转入或转出。
BUY, SELL, DEPOSIT, WITHDRAWAL "BUY"
订单处理状态。完成后再按结算数值进行对账。
PENDING, SUCCESS, FAILED "SUCCESS"
执行或资产转移所用的区块链网络；不可用时为 null。
"Ethereum"
交易使用的资金币种；资产转移记录为 null。
"USDC"
所接受报价中的数量；报价未确定数量或记录属于资产转移时为 null。
^-?[0-9]+(\.[0-9]+)?$"0.00297066689243735"
已完成交易的结算数量；结算前为 null。
^-?[0-9]+(\.[0-9]+)?$"0.00297066689243735"
以 funding_currency 计价的每单位结算价格，不表示资产转移的成本基础。
^-?[0-9]+(\.[0-9]+)?$"336.624750000000055741"
以 funding_currency 计价、不含手续费的结算金额；结算前及资产转移记录为 null。
^-?[0-9]+(\.[0-9]+)?$"1"
已完成订单记录的费用；null 表示尚无已结算费用信息。
Show child attributes
Show child attributes
[
{
"type": "TRADING",
"amount": "0.0005",
"currency": "USDC"
}
]
以 funding_currency 计价，买入时为含手续费的结算总支出，卖出时为扣除手续费后的结算收入；结算前及资产转移记录为 null。
^-?[0-9]+(\.[0-9]+)?$"1.0005"
可用时返回公开交易哈希；null 本身不表示订单失败。
"0x7e7b7f06c0a4adce2ec2bc01b455fd4e014b9f298e7e2598b02c93dffa86a96f"
失败订单的业务失败标识，与 HTTP 错误码分别处理。
订单失败原因的可读说明；未报告失败时为 null。
订单创建时间。
"2026-09-21T01:33:08.629Z"
订单最近更新时间。
"2026-09-21T01:50:53.855Z"
结算完成时间；订单完成前为 null。
"2026-09-21T01:50:53.561Z"
终态失败时间；订单未失败时为 null。
充值或提现的资产数量；买入和卖出订单为 null。
^-?[0-9]+(\.[0-9]+)?$