curl --request POST \
--url 'https://api-sandbox.uqpaytech.com/api/v1/stocks/quote' \
--header "Content-Type: application/json" \
--header "x-auth-token: Bearer ${SANDBOX_TOKEN}" \
--header "x-idempotency-key: ${UNIQUE_IDEMPOTENCY_KEY}" \
--data '{
"asset_id": "7453f146-b267-11f1-b4f4-0abd773ba497",
"side": "BUY",
"funding_currency": "USDC",
"cash_amount": "1"
}'
{
"quote_id": "0576b03b-56dd-48b1-ba24-058ce90d0f53",
"asset_id": "7453f146-b267-11f1-b4f4-0abd773ba497",
"symbol": "AAPLx",
"side": "BUY",
"network": "Ethereum",
"funding_currency": "USDC",
"quantity": "0.00297066689243735",
"price": "336.624750000000055741",
"cash_amount": "1",
"fees": [
{
"type": "TRADING",
"amount": "0.0005",
"currency": "USDC"
}
],
"total_amount": "1.0005",
"created_at": "2026-09-21T01:33:07.797Z",
"expires_at": "2026-09-21T01:34:04.542Z"
}
Stocks
创建报价
按资金金额申请买入报价，或按数量申请卖出报价。仅提交对应的一个正数十进制字符串；创建订单前检查报价有效期和可空字段。 示例包含实际 Sandbox 标识。新操作应获取新报价并使用新幂等键。
POST
/
quote
curl --request POST \
--url 'https://api-sandbox.uqpaytech.com/api/v1/stocks/quote' \
--header "Content-Type: application/json" \
--header "x-auth-token: Bearer ${SANDBOX_TOKEN}" \
--header "x-idempotency-key: ${UNIQUE_IDEMPOTENCY_KEY}" \
--data '{
"asset_id": "7453f146-b267-11f1-b4f4-0abd773ba497",
"side": "BUY",
"funding_currency": "USDC",
"cash_amount": "1"
}'
{
"quote_id": "0576b03b-56dd-48b1-ba24-058ce90d0f53",
"asset_id": "7453f146-b267-11f1-b4f4-0abd773ba497",
"symbol": "AAPLx",
"side": "BUY",
"network": "Ethereum",
"funding_currency": "USDC",
"quantity": "0.00297066689243735",
"price": "336.624750000000055741",
"cash_amount": "1",
"fees": [
{
"type": "TRADING",
"amount": "0.0005",
"currency": "USDC"
}
],
"total_amount": "1.0005",
"created_at": "2026-09-21T01:33:07.797Z",
"expires_at": "2026-09-21T01:34:04.542Z"
}
curl --request POST \
--url 'https://api-sandbox.uqpaytech.com/api/v1/stocks/quote' \
--header "Content-Type: application/json" \
--header "x-auth-token: Bearer ${SANDBOX_TOKEN}" \
--header "x-idempotency-key: ${UNIQUE_IDEMPOTENCY_KEY}" \
--data '{
"asset_id": "7453f146-b267-11f1-b4f4-0abd773ba497",
"side": "BUY",
"funding_currency": "USDC",
"cash_amount": "1"
}'
{
"quote_id": "0576b03b-56dd-48b1-ba24-058ce90d0f53",
"asset_id": "7453f146-b267-11f1-b4f4-0abd773ba497",
"symbol": "AAPLx",
"side": "BUY",
"network": "Ethereum",
"funding_currency": "USDC",
"quantity": "0.00297066689243735",
"price": "336.624750000000055741",
"cash_amount": "1",
"fees": [
{
"type": "TRADING",
"amount": "0.0005",
"currency": "USDC"
}
],
"total_amount": "1.0005",
"created_at": "2026-09-21T01:33:07.797Z",
"expires_at": "2026-09-21T01:34:04.542Z"
}
授权
由 UQPAY 提供的登录 API Token。
请求头
用于维持操作幂等性的唯一标识符。同一操作重试时使用相同的键和请求内容；新的操作使用新的键。
Pattern:
^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$请求体
application/json
响应
成功
创建订单时提交的报价标识。
示例:
"0576b03b-56dd-48b1-ba24-058ce90d0f53"
平台资产 UUID，列表与所有交易接口共用
示例:
"7453f146-b267-11f1-b4f4-0abd773ba497"
资产代码。
示例:
"AAPLx"
拟进行交易的方向。
可用选项:
BUY, SELL 示例:
"BUY"
报价所选的区块链网络；报价请求不指定网络。
示例:
"Ethereum"
资金币种，现为 USDC
可用选项:
USDC 示例:
"USDC"
报价中的资产数量；需要在执行时确定数量时为 null。
Pattern:
^-?[0-9]+(\.[0-9]+)?$示例:
"0.00297066689243735"
以 funding_currency 计价的每单位报价；报价未确定执行价格时为 null。
Pattern:
^-?[0-9]+(\.[0-9]+)?$示例:
"336.624750000000055741"
以 funding_currency 计价、不含手续费的交易金额；需要在执行时确定时为 null。
Pattern:
^-?[0-9]+(\.[0-9]+)?$示例:
"1"
报价中的费用。null 表示费用暂不可用，不代表免收费用。
Show child attributes
Show child attributes
以 funding_currency 计价，买入时为含手续费的总支出，卖出时为扣除手续费后的收入；尚无法确定时为 null。
Pattern:
^-?[0-9]+(\.[0-9]+)?$示例:
"1.0005"
报价创建时间。
示例:
"2026-09-21T01:33:07.797Z"
客户确认截止时间；过期后应申请新报价
示例:
"2026-09-21T01:34:04.542Z"