获取意图取消订单签名数据#
获取取消意图订单所需的 EIP-712 签名数据。拿到 signData 后,使用订单持有者的钱包对其签名,再将签名结果提交至取消订单接口完成取消操作。
请求地址#
POST
https://web3.okx.com/api/v6/dex/aggregator/intent/cancel-signdata请求参数#
| 参数 | 类型 | 必传 | 描述 |
|---|---|---|---|
| userWalletAddress | String | 是 | 下单者钱包地址。 |
| orderUid | String | 是 | 需要取消的意图订单唯一标识。 |
响应参数#
| 参数 | 类型 | 描述 |
|---|---|---|
| signData | Object | 订单持有者需要签名的 EIP-712 结构化数据,用于授权取消操作。 |
| primaryType | String | EIP-712 主类型。固定值:CancelOrder。 |
| domain | Object | EIP-712 域分隔符信息。 |
| name | String | 域名称。固定值:OKX Intent Swap。 |
| version | String | 域版本号。 |
| chainId | Integer | 订单所在链的 Chain ID。 |
| verifyingContract | String | 用于验证签名的合约地址。 |
| message | Object | 待签名的取消操作载荷。 |
| orderUid | String | 需要取消的订单唯一标识。 |
| ypes | Object | EIP-712 结构化数据的类型定义。 |
| EIP712Domain | Array | 域分隔符各字段的类型定义。 |
| CancelOrder | Array | 取消消息各字段的类型定义。 |
请求示例#
shell
curl --location --request POST 'https://web3.okx.com/api/v6/dex/aggregator/intent/cancel-signdata' \
--header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \
--header 'OK-ACCESS-SIGN: leaV********3uw=' \
--header 'OK-ACCESS-PASSPHRASE: 1****6' \
--header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' \
--header 'Content-Type: application/json' \
--data-raw '{
"userWalletAddress": "0x5B38Da6a701c568545dCfcB03FcB875f56beddC4",
"orderUid": "0xfa2506196276f31c6bf7f4a2f02f3bd5ad80ed91354441ce4d5f28c87021e64c5b38da6a701c568545dcfcb03fcb875f56beddc469bbd743"
}'
响应示例#
json
{
"code": "0",
"msg": "",
"data": {
"signData": {
"domain": {
"chainId": 1,
"name": "OKX Intent Swap",
"verifyingContract": "0x1111111254fb6c44bac0bed2854e76f90643097d",
"version": "1"
},
"message": {
"orderUid": "0xfa2506196276f31c6bf7f4a2f02f3bd5ad80ed91354441ce4d5f28c87021e64c5b38da6a701c568545dcfcb03fcb875f56beddc469bbd743"
},
"primaryType": "CancelOrder",
"types": {
"CancelOrder": [
{ "name": "orderUid", "type": "bytes" }
],
"EIP712Domain": [
{ "name": "name", "type": "string" },
{ "name": "version", "type": "string" },
{ "name": "chainId", "type": "uint256" },
{ "name": "verifyingContract", "type": "address" }
]
}
}
}
}
