获取意图取消订单签名数据#

获取取消意图订单所需的 EIP-712 签名数据。拿到 signData 后,使用订单持有者的钱包对其签名,再将签名结果提交至取消订单接口完成取消操作。

请求地址#

POST
https://web3.okx.com/api/v6/dex/aggregator/intent/cancel-signdata

请求参数#

参数类型必传描述
userWalletAddressString下单者钱包地址。
orderUidString需要取消的意图订单唯一标识。

响应参数#

参数类型描述
signDataObject订单持有者需要签名的 EIP-712 结构化数据,用于授权取消操作。
primaryTypeStringEIP-712 主类型。固定值:CancelOrder
domainObjectEIP-712 域分隔符信息。
nameString域名称。固定值:OKX Intent Swap
versionString域版本号。
chainIdInteger订单所在链的 Chain ID。
verifyingContractString用于验证签名的合约地址。
messageObject待签名的取消操作载荷。
orderUidString需要取消的订单唯一标识。
ypesObjectEIP-712 结构化数据的类型定义。
EIP712DomainArray域分隔符各字段的类型定义。
CancelOrderArray取消消息各字段的类型定义。

请求示例#

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" }
                ]
            }
        }
    }
}