Automated Orders Notifications
Webhook
POSTautomated-trade
The events include the following statuses:
Examples
1. Finished
{
"params": {
"user_id": "1ef2efc7-1d0c-658b-8bdb-7398fd6afe94",
"order_id": "01ef5401-cf20-6165-b0cb-3e1e8185fb3c",
"trade_id": "01ef5401-cf20-6165-b0cb-3e1e8185fb3c",
"asset_id": "a49406ee-ee33-11ec-aafe-062d595118ef",
"fiat_id": "ea96ccef-edee-11eb-9bf0-06502b1fe55d",
"asset_amount": "2.43667276",
"fiat_amount": "1",
"type": "buy",
"status": "finished",
"created_at": "2024-08-06T14:40:21.848515Z",
"external_order_id": "partner-order-12345"
}
}2. Failed (with reason, slippage evaluation)
{
"params": {
"user_id": "1ef2efc7-1d0c-658b-8bdb-7398fd6afe94",
"order_id": "01ef52f5-9f60-60e1-8165-8a61e573af23",
"trade_id": null,
"asset_id": "a49406ee-ee33-11ec-aafe-062d595118ef",
"fiat_id": "ea96d0fc-edee-11eb-9bf0-06502b1fe55d",
"asset_amount": null,
"fiat_amount": null,
"type": "buy",
"status": "failed",
"fail_reason": "slippage.evaluation",
"created_at": "2024-08-05T06:40:36.612535Z",
"external_order_id": "partner-order-12345"
}
}3. Cancelled (with reason, user action)
{
"params": {
"user_id": "1ef50a17-5397-610c-bc4b-5de229acd5eb",
"order_id": "01ef50be-98ba-678f-aeb0-164c3edf7ee5",
"trade_id": null,
"asset_id": "ea96ccef-edee-11eb-9bf0-06502b1fe55d",
"fiat_id": "1eebacd8-7001-6ebe-97ca-dd9f96ed2091",
"asset_amount": null,
"fiat_amount": null,
"type": "buy",
"status": "cancelled",
"fail_reason": "cancelled.by.user",
"created_at": "2026-05-13T11:54:45.362129Z",
"external_order_id": null
}
}4. Cancelled (with reason, auto-canceling)
{
"params": {
"user_id": "1ef50a17-5397-610c-bc4b-5de229acd5eb",
"order_id": "01ef50da-52c7-6848-9b66-8a418b68cf6f",
"trade_id": null,
"asset_id": "1eebacd8-7001-6ebe-97ca-dd9f96ed2091",
"fiat_id": "ea96ccef-edee-11eb-9bf0-06502b1fe55d",
"asset_amount": null,
"fiat_amount": null,
"type": "buy",
"status": "cancelled",
"fail_reason": "cancelled.due.to.asset.disabling",
"created_at": "2026-05-13T11:54:45.362129Z",
"external_order_id": null
}
}5. Expired
{
"params": {
"user_id": "1ef50a17-5397-610c-bc4b-5de229acd5eb",
"order_id": "01ef50da-52c7-6848-9b66-8a418b68cf6f",
"trade_id": null,
"asset_id": "1eebacd8-7001-6ebe-97ca-dd9f96ed2091",
"fiat_id": "ea96ccef-edee-11eb-9bf0-06502b1fe55d",
"asset_amount": null,
"fiat_amount": null,
"type": "buy",
"status": "expired",
"fail_reason": "expired",
"created_at": "2026-04-13T11:07:52.487958Z",
"external_order_id": "b625e3a6-855f-4bc3-8460-4618336efb32_Test"
}
}6. Failed (with reason, user account inactive)
{
"params": {
"user_id": "1ef50a17-5397-610c-bc4b-5de229acd5eb",
"order_id": "01ef50da-52c7-6848-9b66-8a418b68cf6f",
"trade_id": null,
"asset_id": "1eebacd8-7001-6ebe-97ca-dd9f96ed2091",
"fiat_id": "ea96ccef-edee-11eb-9bf0-06502b1fe55d",
"asset_amount": null,
"fiat_amount": null,
"type": "buy",
"status": "failed",
"fail_reason": "user.account.inactive",
"created_at": "2026-04-09T11:22:47.836729Z",
"external_order_id": "b625e3a6-855f-4bc3-8460-4618336efb32_Test"
}
}7. Failed (with reason, user transaction inactive cryptocoins)
{
"params": {
"user_id": "1ef50a17-5397-610c-bc4b-5de229acd5eb",
"order_id": "01ef50da-52c7-6848-9b66-8a418b68cf6f",
"trade_id": null,
"asset_id": "1eebacd8-7001-6ebe-97ca-dd9f96ed2091",
"fiat_id": "ea96ccef-edee-11eb-9bf0-06502b1fe55d",
"asset_amount": null,
"fiat_amount": null,
"type": "buy",
"status": "failed",
"fail_reason": "user.transaction.inactive.cryptocoin",
"created_at": "2026-04-09T11:22:47.836729Z",
"external_order_id": "b625e3a6-855f-4bc3-8460-4618336efb32_Test"
}
}8. Failed (with reason, user transaction trading disabled)
{
"params": {
"user_id": "1ef50a17-5397-610c-bc4b-5de229acd5eb",
"order_id": "01ef50da-52c7-6848-9b66-8a418b68cf6f",
"trade_id": null,
"asset_id": "1eebacd8-7001-6ebe-97ca-dd9f96ed2091",
"fiat_id": "ea96ccef-edee-11eb-9bf0-06502b1fe55d",
"asset_amount": null,
"fiat_amount": null,
"type": "buy",
"status": "failed",
"fail_reason": "user.transaction.trading.disabled",
"created_at": "2026-04-09T11:22:47.836729Z",
"external_order_id": "b625e3a6-855f-4bc3-8460-4618336efb32_Test"
}
}9. Failed (with reason, user transaction operations disabled)
{
"params": {
"user_id": "1ef50a17-5397-610c-bc4b-5de229acd5eb",
"order_id": "01ef50da-52c7-6848-9b66-8a418b68cf6f",
"trade_id": null,
"asset_id": "1eebacd8-7001-6ebe-97ca-dd9f96ed2091",
"fiat_id": "ea96ccef-edee-11eb-9bf0-06502b1fe55d",
"asset_amount": null,
"fiat_amount": null,
"type": "buy",
"status": "failed",
"fail_reason": "user.transaction.operations.disabled",
"created_at": "2026-04-09T11:22:47.836729Z",
"external_order_id": "b625e3a6-855f-4bc3-8460-4618336efb32_Test"
}
}10. Failed (with reason, order execution error)
{
"params": {
"order_id": "01ef50da-52c7-6848-9b66-8a418b68cf6f",
"trade_id": null,
"asset_id": "1eebacd8-7001-6ebe-97ca-dd9f96ed2091",
"fiat_id": "ea96ccef-edee-11eb-9bf0-06502b1fe55d",
"asset_amount": null,
"fiat_amount": null,
"type": "buy",
"status": "failed",
"fail_reason": "order.execution.error",
"created_at": "2026-04-09T11:22:47.836729Z",
"external_order_id": "b625e3a6-855f-4bc3-8460-4618336efb32_Test"
}
}Request
Header Params
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Go
curl --location 'https://your-api-server.com' \
--header 'X-BTS-Idempotency-Key;' \
--header 'Signature;' \
--header 'Content-Digest;' \
--header 'Date;' \
--header 'Content-Type: application/json' \
--data '{
"params": {
"user_id": "6c568238-11f0-4120-9ca0-c5dac1640793",
"order_id": "2e4c89ac-1290-426f-8de0-4c7b40b91d3a",
"trade_id": "bfb0f958-f0ff-4f69-b9f5-7440b71b564c",
"asset_id": "b2b46500-ff30-486f-8e60-4b90754eb8c6",
"fiat_id": "bd6e2a67-ef17-47f9-8c4f-5547907baee5",
"asset_amount": "string",
"fiat_amount": "string",
"type": "buy",
"status": "finished",
"fail_reason": "slippage.evaluation",
"created_at": "2022-11-11T13:07:31+00:00",
"external_order_id": "partner-order-12345"
}
}'Modified at 2026-06-01 11:50:47