Prepare a perp cancel

Prepare a perp cancel

post

Build an unsigned cancel for one resting order.

Same prepare → sign → execute flow as /api/v1/perp/order: sign the returned eip712 payload and submit it to /api/v1/perp/execute. This call cancels nothing on its own.

order_id is the exchange's order id (oid) — take it from /api/v1/perp/orders, or from the execute response that placed the order. Cancelling an order that has already filled or been cancelled is rejected with a 422.

Authorizations

ApiKeyAuth

apikeystringRequired

API key for authentication

Body

application/json

Prepare a cancel for an open order.

wallet_addressstringRequired

Wallet address on Hyperliquid

Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

coinstringRequired

Asset symbol

Example: BTC

order_idintegerRequired

Exchange order id (oid) of the order to cancel, as returned by /api/v1/perp/orders or by the execute call that placed it

Example: 123456789

Responses

200

Successful Response

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Unprocessable Content

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

502

Bad Gateway

application/json

503

Service Unavailable

application/json

504

Gateway Timeout

application/json

post/api/v1/perp/cancel

HTTPcURLJavaScriptPython

POST /api/v1/perp/cancel HTTP/1.1
Host: api.nansen.ai
apikey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 97

{
  "wallet_address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "coin": "BTC",
  "order_id": 123456789
}

{
  "action": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "nonce": 1,
  "vault_address": "text",
  "eip712": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "size": 1,
  "price": 1,
  "ANY_ADDITIONAL_PROPERTY": "anything"
}