Skip to main content
POST
/
v1
/
sender
/
orders
/
{id}
/
cancel
Cancel Order
curl --request POST \
  --url https://b2b.usetapp.xyz/v1/sender/orders/{id}/cancel \
  --header 'API-Key: <api-key>'
{
  "status": "success",
  "message": "Order cancelled",
  "data": { "id": "c7326d65-dfff-44c2-8bcc-c0756dfb6c0a", "status": "cancelled" }
}
Cancels an order you own. Orders that are already final (cancelled, expired, settled, refunded) are returned unchanged with a message noting they are final.
Cancelling only affects Rails’ order record. For a non-custodial EVM/Starknet order, if you have already submitted createOrder on-chain, settlement follows the on-chain state — cancel before you submit.

​
Header Parameters

​
API-Key
string
required
Unique API key issued manually through Telegram.

​
Path Parameters

​
id
string
required
The order id (orderRef) returned at creation.

​
Response

​
status
string
Response state (success).
​
data
object
​
id
string
Order id.
​
status
string
Lifecycle state — cancelled on success.
{
  "status": "success",
  "message": "Order cancelled",
  "data": { "id": "c7326d65-dfff-44c2-8bcc-c0756dfb6c0a", "status": "cancelled" }
}