跳转到主要内容
POST

授权

Authorization
string
header
必填

会话 JWT(来自注册/登录)或 API key(pk_...)。 也接受 X-API-Key: <token> 作为替代请求头。

请求头

Idempotency-Key
string

idempotency_key 请求体字段的替代方式。

请求体

application/json
from_asset
enum<string>
必填
可用选项:
USDT,
USDC,
BTC,
GOLD
to_asset
enum<string>
必填
可用选项:
USDT,
USDC,
BTC,
GOLD
amount
string
必填

源货币金额(USDT/USDC/GOLD 为 6 位小数,BTC 为 8 位)。

idempotency_key
string

响应

幂等重放(原始 swap,绝不重复执行)。

swap_id
string<uuid>
account_id
string<uuid>

所属账户。使组织管理员能在全组织视图中归属每条记录。

from_asset
enum<string>
可用选项:
USDT,
USDC,
BTC,
GOLD
to_asset
enum<string>
可用选项:
USDT,
USDC,
BTC,
GOLD
from_amount
string
to_amount
string
rate
string

每单位源资产可得的目标资产单位数(标记后的执行汇率)。

status
string
示例:

"completed"

idempotency_key
string
created_at
string<date-time>
idempotency_hit
boolean

重放时出现。

最后修改于 2026年7月19日