Události webhooků
Coinero posílá události na HTTPS cíl partnera jako požadavek POST s JSON tělem. Postup, podpis, opakování a ukázky příjmu jsou na stránce Webhooky; tato kapitola popisuje těla událostí.
Ukázky jsou z kontraktu.
Obálka
| Pole | Popis |
|---|---|
| eventIdstring | Identifikátor události (UUID), shodný s hlavičkou X-COINERO-EVENT-ID. Podle něj deduplikujte: doručení je alespoň jednou. |
| typestring | Typ události, viz níže. Nové typy mohou v rámci v1 přibýt; neznámý typ zpracujte bez selhání. |
| occurredAtstring | Okamžik vzniku události, ISO 8601, UTC. Podle něj a podle stavu v data řaďte, pořadí doručení není zaručené. |
| occurredAtMsinteger | Stejný okamžik jako Unix timestamp v milisekundách. |
| partnerCodestring | Kód vašeho partnerského účtu. |
| dataobject | Předmět události. Tvar závisí na typu. |
U pokynů a subúčtů je pole data týž objekt jako v odpovědi REST a stejně serializovaný: částky jsou desetinné řetězce, časy dvakrát (ISO 8601 a milisekundy), nepoužitá pole mají hodnotu null. Pole objektů popisují reference GET …/orders/{orderId} a GET /v1/subaccounts/{externalClientRef}.
Pokyny
Pole data je objekt pokynu s blokem partner, týž jako vrací GET …/orders/{orderId}.
order.pendingConfirmation
Nákup přijatý přes API čeká na potvrzení blokace peněz klienta.
data: Objekt pokynu s blokem partner, týž jako v odpovědi GET …/orders/{orderId}, ve stavu z okamžiku události.
{
"eventId": "0193a1b2-5c3d-7e4f-8a9b-000000000001",
"type": "order.pendingConfirmation",
"occurredAt": "2026-10-28T09:15:00.123Z",
"occurredAtMs": 1793178900123,
"partnerCode": "ABCD",
"data": {
"orderId": "0193a1b2-0000-7000-8000-000000000101",
"clientOrderId": "order-2026-10-24-0001",
"symbol": "BTCCZK",
"base": "BTC",
"quote": "CZK",
"side": "buy",
"type": "market",
"status": "pendingConfirmation",
"settled": false,
"cancellable": false,
"requestedQuantity": null,
"requestedQuoteQuantity": "5000.0000",
"price": null,
"filledQuantity": "0.00000000",
"averagePrice": null,
"fee": null,
"spent": {
"amount": "0.0000",
"currency": "CZK"
},
"received": {
"amount": "0.00000000",
"currency": "BTC"
},
"conversion": null,
"rejectionReason": null,
"createdAt": "2026-10-28T09:14:50.000Z",
"createdAtMs": 1793178890000,
"filledAt": null,
"filledAtMs": null,
"settledAt": null,
"settledAtMs": null,
"partner": {
"orderNumber": "ABCD-0000000001",
"externalClientRef": "client-0001234",
"feeAmount": {
"amount": "50.0000",
"currency": "CZK"
},
"totalAmount": {
"amount": "5050.0000",
"currency": "CZK"
},
"netProceeds": null,
"blockDeadline": "2026-10-28T09:15:20.000Z",
"blockDeadlineMs": 1793178920000,
"confirmationRequired": true,
"confirmedAt": null,
"confirmedAtMs": null,
"settledAt": null,
"settledAtMs": null
}
}
}order.new
Pokyn je financovaný (nákup po potvrzení) nebo přijatý k provedení (prodej). Vzniká i u pokynů zadaných za subúčet mimo API.
data: Objekt pokynu s blokem partner, týž jako v odpovědi GET …/orders/{orderId}, ve stavu z okamžiku události.
{
"eventId": "0193a1b2-5c3d-7e4f-8a9b-000000000008",
"type": "order.new",
"occurredAt": "2026-10-28T09:15:00.123Z",
"occurredAtMs": 1793178900123,
"partnerCode": "ABCD",
"data": {
"orderId": "0193a1b2-0000-7000-8000-000000000101",
"clientOrderId": "order-2026-10-24-0001",
"symbol": "BTCCZK",
"base": "BTC",
"quote": "CZK",
"side": "buy",
"type": "market",
"status": "new",
"settled": false,
"cancellable": false,
"requestedQuantity": null,
"requestedQuoteQuantity": "5000.0000",
"price": null,
"filledQuantity": "0.00000000",
"averagePrice": null,
"fee": null,
"spent": {
"amount": "0.0000",
"currency": "CZK"
},
"received": {
"amount": "0.00000000",
"currency": "BTC"
},
"conversion": null,
"rejectionReason": null,
"createdAt": "2026-10-28T09:14:50.000Z",
"createdAtMs": 1793178890000,
"filledAt": null,
"filledAtMs": null,
"settledAt": null,
"settledAtMs": null,
"partner": {
"orderNumber": "ABCD-0000000001",
"externalClientRef": "client-0001234",
"feeAmount": {
"amount": "50.0000",
"currency": "CZK"
},
"totalAmount": {
"amount": "5050.0000",
"currency": "CZK"
},
"netProceeds": null,
"blockDeadline": null,
"blockDeadlineMs": null,
"confirmationRequired": true,
"confirmedAt": "2026-10-28T09:14:55.000Z",
"confirmedAtMs": 1793178895000,
"settledAt": null,
"settledAtMs": null
}
}
}order.partiallyFilled
Obchod skončil částečným plněním a zbytek se vrátil. Není to průběžné plnění: událost přijde jednou, na konci obchodu.
data: Objekt pokynu s blokem partner, týž jako v odpovědi GET …/orders/{orderId}, ve stavu z okamžiku události.
{
"eventId": "0193a1b2-5c3d-7e4f-8a9b-000000000009",
"type": "order.partiallyFilled",
"occurredAt": "2026-10-28T09:15:00.123Z",
"occurredAtMs": 1793178900123,
"partnerCode": "ABCD",
"data": {
"orderId": "0193a1b2-0000-7000-8000-000000000101",
"clientOrderId": "order-2026-10-24-0001",
"symbol": "BTCCZK",
"base": "BTC",
"quote": "CZK",
"side": "buy",
"type": "market",
"status": "filled",
"settled": true,
"cancellable": false,
"requestedQuantity": null,
"requestedQuoteQuantity": "5000.0000",
"price": null,
"filledQuantity": "0.00396039",
"averagePrice": "1262500.0",
"fee": {
"amount": "0.00000000",
"currency": "BTC"
},
"spent": {
"amount": "5000.0000",
"currency": "CZK"
},
"received": {
"amount": "0.00396039",
"currency": "BTC"
},
"conversion": {
"rate": "25.2500",
"currency": "EUR"
},
"rejectionReason": null,
"createdAt": "2026-10-28T09:14:55.000Z",
"createdAtMs": 1793178895000,
"filledAt": "2026-10-28T09:14:57.000Z",
"filledAtMs": 1793178897000,
"settledAt": "2026-10-28T09:14:58.000Z",
"settledAtMs": 1793178898000,
"partner": {
"orderNumber": "ABCD-0000000001",
"externalClientRef": "client-0001234",
"feeAmount": {
"amount": "50.0000",
"currency": "CZK"
},
"totalAmount": {
"amount": "5050.0000",
"currency": "CZK"
},
"netProceeds": null,
"blockDeadline": null,
"blockDeadlineMs": null,
"confirmationRequired": true,
"confirmedAt": "2026-10-28T09:14:55.000Z",
"confirmedAtMs": 1793178895000,
"settledAt": null,
"settledAtMs": null
}
}
}order.filled
Obchod skončil plným naplněním.
data: Objekt pokynu s blokem partner, týž jako v odpovědi GET …/orders/{orderId}, ve stavu z okamžiku události.
{
"eventId": "0193a1b2-5c3d-7e4f-8a9b-000000000002",
"type": "order.filled",
"occurredAt": "2026-10-28T09:15:00.123Z",
"occurredAtMs": 1793178900123,
"partnerCode": "ABCD",
"data": {
"orderId": "0193a1b2-0000-7000-8000-000000000101",
"clientOrderId": "order-2026-10-24-0001",
"symbol": "BTCCZK",
"base": "BTC",
"quote": "CZK",
"side": "buy",
"type": "market",
"status": "filled",
"settled": true,
"cancellable": false,
"requestedQuantity": null,
"requestedQuoteQuantity": "5000.0000",
"price": null,
"filledQuantity": "0.00396039",
"averagePrice": "1262500.0",
"fee": {
"amount": "0.00000000",
"currency": "BTC"
},
"spent": {
"amount": "5000.0000",
"currency": "CZK"
},
"received": {
"amount": "0.00396039",
"currency": "BTC"
},
"conversion": {
"rate": "25.2500",
"currency": "EUR"
},
"rejectionReason": null,
"createdAt": "2026-10-28T09:14:55.000Z",
"createdAtMs": 1793178895000,
"filledAt": "2026-10-28T09:14:57.000Z",
"filledAtMs": 1793178897000,
"settledAt": "2026-10-28T09:14:58.000Z",
"settledAtMs": 1793178898000,
"partner": {
"orderNumber": "ABCD-0000000001",
"externalClientRef": "client-0001234",
"feeAmount": {
"amount": "50.0000",
"currency": "CZK"
},
"totalAmount": {
"amount": "5050.0000",
"currency": "CZK"
},
"netProceeds": null,
"blockDeadline": null,
"blockDeadlineMs": null,
"confirmationRequired": true,
"confirmedAt": "2026-10-28T09:14:55.000Z",
"confirmedAtMs": 1793178895000,
"settledAt": null,
"settledAtMs": null
}
}
}order.cancelled
Pokyn byl zrušen: nepotvrzený nákup po lhůtě blokace (rejectionReason blockTimeout), nebo zrušení bez plnění.
data: Objekt pokynu s blokem partner, týž jako v odpovědi GET …/orders/{orderId}, ve stavu z okamžiku události.
{
"eventId": "0193a1b2-5c3d-7e4f-8a9b-000000000003",
"type": "order.cancelled",
"occurredAt": "2026-10-28T09:15:00.123Z",
"occurredAtMs": 1793178900123,
"partnerCode": "ABCD",
"data": {
"orderId": "0193a1b2-0000-7000-8000-000000000101",
"clientOrderId": "order-2026-10-24-0001",
"symbol": "BTCCZK",
"base": "BTC",
"quote": "CZK",
"side": "buy",
"type": "market",
"status": "cancelled",
"settled": false,
"cancellable": false,
"requestedQuantity": null,
"requestedQuoteQuantity": "5000.0000",
"price": null,
"filledQuantity": "0.00000000",
"averagePrice": null,
"fee": null,
"spent": {
"amount": "0.0000",
"currency": "CZK"
},
"received": {
"amount": "0.00000000",
"currency": "BTC"
},
"conversion": null,
"rejectionReason": "blockTimeout",
"createdAt": "2026-10-28T09:14:50.000Z",
"createdAtMs": 1793178890000,
"filledAt": null,
"filledAtMs": null,
"settledAt": null,
"settledAtMs": null,
"partner": {
"orderNumber": "ABCD-0000000001",
"externalClientRef": "client-0001234",
"feeAmount": {
"amount": "50.0000",
"currency": "CZK"
},
"totalAmount": {
"amount": "5050.0000",
"currency": "CZK"
},
"netProceeds": null,
"blockDeadline": null,
"blockDeadlineMs": null,
"confirmationRequired": true,
"confirmedAt": null,
"confirmedAtMs": null,
"settledAt": null,
"settledAtMs": null
}
}
}order.rejected
Pokyn byl zamítnut kvůli pohybu ceny přes ochrannou mez (priceMoved), odmítnutí burzou nebo obchodním pravidlům.
data: Objekt pokynu s blokem partner, týž jako v odpovědi GET …/orders/{orderId}, ve stavu z okamžiku události.
{
"eventId": "0193a1b2-5c3d-7e4f-8a9b-000000000010",
"type": "order.rejected",
"occurredAt": "2026-10-28T09:15:00.123Z",
"occurredAtMs": 1793178900123,
"partnerCode": "ABCD",
"data": {
"orderId": "0193a1b2-0000-7000-8000-000000000101",
"clientOrderId": "order-2026-10-24-0001",
"symbol": "BTCCZK",
"base": "BTC",
"quote": "CZK",
"side": "buy",
"type": "market",
"status": "rejected",
"settled": false,
"cancellable": false,
"requestedQuantity": null,
"requestedQuoteQuantity": "5000.0000",
"price": null,
"filledQuantity": "0.00000000",
"averagePrice": null,
"fee": null,
"spent": {
"amount": "0.0000",
"currency": "CZK"
},
"received": {
"amount": "0.00000000",
"currency": "BTC"
},
"conversion": null,
"rejectionReason": "priceMoved",
"createdAt": "2026-10-28T09:14:50.000Z",
"createdAtMs": 1793178890000,
"filledAt": null,
"filledAtMs": null,
"settledAt": null,
"settledAtMs": null,
"partner": {
"orderNumber": "ABCD-0000000001",
"externalClientRef": "client-0001234",
"feeAmount": {
"amount": "50.0000",
"currency": "CZK"
},
"totalAmount": {
"amount": "5050.0000",
"currency": "CZK"
},
"netProceeds": null,
"blockDeadline": null,
"blockDeadlineMs": null,
"confirmationRequired": true,
"confirmedAt": "2026-10-28T09:14:55.000Z",
"confirmedAtMs": 1793178895000,
"settledAt": null,
"settledAtMs": null
}
}
}order.settled
Pokyn je vypořádaný s vaším partnerským účtem, pole partner.settledAt je vyplněné. Stav status se nemění.
data: Objekt pokynu s blokem partner, týž jako v odpovědi GET …/orders/{orderId}, ve stavu z okamžiku události.
{
"eventId": "0193a1b2-5c3d-7e4f-8a9b-000000000011",
"type": "order.settled",
"occurredAt": "2026-10-28T09:15:00.123Z",
"occurredAtMs": 1793178900123,
"partnerCode": "ABCD",
"data": {
"orderId": "0193a1b2-0000-7000-8000-000000000101",
"clientOrderId": "order-2026-10-24-0001",
"symbol": "BTCCZK",
"base": "BTC",
"quote": "CZK",
"side": "buy",
"type": "market",
"status": "filled",
"settled": true,
"cancellable": false,
"requestedQuantity": null,
"requestedQuoteQuantity": "5000.0000",
"price": null,
"filledQuantity": "0.00396039",
"averagePrice": "1262500.0",
"fee": {
"amount": "0.00000000",
"currency": "BTC"
},
"spent": {
"amount": "5000.0000",
"currency": "CZK"
},
"received": {
"amount": "0.00396039",
"currency": "BTC"
},
"conversion": {
"rate": "25.2500",
"currency": "EUR"
},
"rejectionReason": null,
"createdAt": "2026-10-28T09:14:55.000Z",
"createdAtMs": 1793178895000,
"filledAt": "2026-10-28T09:14:57.000Z",
"filledAtMs": 1793178897000,
"settledAt": "2026-10-28T09:14:58.000Z",
"settledAtMs": 1793178898000,
"partner": {
"orderNumber": "ABCD-0000000001",
"externalClientRef": "client-0001234",
"feeAmount": {
"amount": "50.0000",
"currency": "CZK"
},
"totalAmount": {
"amount": "5050.0000",
"currency": "CZK"
},
"netProceeds": null,
"blockDeadline": null,
"blockDeadlineMs": null,
"confirmationRequired": true,
"confirmedAt": "2026-10-28T09:14:55.000Z",
"confirmedAtMs": 1793178895000,
"settledAt": "2026-10-28T09:14:59.000Z",
"settledAtMs": 1793178899000
}
}
}Subúčty
Pole data je objekt subúčtu, týž jako vrací GET /v1/subaccounts/{externalClientRef}.
subaccount.activated
Subúčet je aktivní, po automatické aktivaci s převzatou identifikací i po aktivaci Coinerem.
data: Objekt subúčtu, týž jako v odpovědi GET /v1/subaccounts/{externalClientRef}, ve stavu z okamžiku události.
{
"eventId": "0193a1b2-5c3d-7e4f-8a9b-000000000004",
"type": "subaccount.activated",
"occurredAt": "2026-10-28T09:15:00.123Z",
"occurredAtMs": 1793178900123,
"partnerCode": "ABCD",
"data": {
"externalClientRef": "client-0001234",
"status": "active",
"createdAt": "2026-10-28T09:14:50.000Z",
"createdAtMs": 1793178890000,
"activatedAt": "2026-10-28T09:15:00.123Z",
"activatedAtMs": 1793178900123,
"closedAt": null,
"closedAtMs": null,
"updatedAt": "2026-10-28T09:15:00.123Z",
"updatedAtMs": 1793178900123,
"limits": {
"minOrderAmount": {
"amount": "100.0000",
"currency": "CZK"
},
"maxOrderAmount": null,
"dailyLimit": {
"amount": "100000.0000",
"currency": "CZK"
},
"dailyLimitRemaining": {
"amount": "94950.0000",
"currency": "CZK"
}
},
"allowedMarkets": [
"BTCCZK",
"ETHCZK"
],
"contact": {
"email": "jana.novakova@example.com",
"phone": "+420777299806"
}
}
}subaccount.rejected
Subúčet byl zamítnut.
data: Objekt subúčtu, týž jako v odpovědi GET /v1/subaccounts/{externalClientRef}, ve stavu z okamžiku události.
{
"eventId": "0193a1b2-5c3d-7e4f-8a9b-000000000012",
"type": "subaccount.rejected",
"occurredAt": "2026-10-28T09:15:00.123Z",
"occurredAtMs": 1793178900123,
"partnerCode": "ABCD",
"data": {
"externalClientRef": "client-0001234",
"status": "rejected",
"createdAt": "2026-10-28T09:14:50.000Z",
"createdAtMs": 1793178890000,
"activatedAt": null,
"activatedAtMs": null,
"closedAt": null,
"closedAtMs": null,
"updatedAt": "2026-10-28T09:15:00.123Z",
"updatedAtMs": 1793178900123,
"limits": {
"minOrderAmount": {
"amount": "100.0000",
"currency": "CZK"
},
"maxOrderAmount": null,
"dailyLimit": {
"amount": "100000.0000",
"currency": "CZK"
},
"dailyLimitRemaining": {
"amount": "94950.0000",
"currency": "CZK"
}
},
"allowedMarkets": [
"BTCCZK",
"ETHCZK"
],
"contact": {
"email": "jana.novakova@example.com",
"phone": "+420777299806"
}
}
}subaccount.blocked
Subúčet byl zablokován.
data: Objekt subúčtu, týž jako v odpovědi GET /v1/subaccounts/{externalClientRef}, ve stavu z okamžiku události.
{
"eventId": "0193a1b2-5c3d-7e4f-8a9b-000000000013",
"type": "subaccount.blocked",
"occurredAt": "2026-10-28T09:15:00.123Z",
"occurredAtMs": 1793178900123,
"partnerCode": "ABCD",
"data": {
"externalClientRef": "client-0001234",
"status": "blocked",
"createdAt": "2026-10-28T09:14:50.000Z",
"createdAtMs": 1793178890000,
"activatedAt": "2026-10-28T09:15:00.123Z",
"activatedAtMs": 1793178900123,
"closedAt": null,
"closedAtMs": null,
"updatedAt": "2026-10-28T09:15:00.123Z",
"updatedAtMs": 1793178900123,
"limits": {
"minOrderAmount": {
"amount": "100.0000",
"currency": "CZK"
},
"maxOrderAmount": null,
"dailyLimit": {
"amount": "100000.0000",
"currency": "CZK"
},
"dailyLimitRemaining": {
"amount": "94950.0000",
"currency": "CZK"
}
},
"allowedMarkets": [
"BTCCZK",
"ETHCZK"
],
"contact": {
"email": "jana.novakova@example.com",
"phone": "+420777299806"
}
}
}subaccount.closed
Subúčet byl ukončen (vaším požadavkem DELETE /v1/subaccounts/{externalClientRef}, nebo Coinerem). Stav closed je konečný; opakované ukončení událost nepošle.
data: Objekt subúčtu, týž jako v odpovědi GET /v1/subaccounts/{externalClientRef}, ve stavu z okamžiku události.
{
"eventId": "0193a1b2-5c3d-7e4f-8a9b-000000000014",
"type": "subaccount.closed",
"occurredAt": "2026-10-28T09:15:00.123Z",
"occurredAtMs": 1793178900123,
"partnerCode": "ABCD",
"data": {
"externalClientRef": "client-0001234",
"status": "closed",
"createdAt": "2026-10-28T09:14:50.000Z",
"createdAtMs": 1793178890000,
"activatedAt": "2026-10-28T09:15:00.123Z",
"activatedAtMs": 1793178900123,
"closedAt": "2026-10-28T09:15:00.123Z",
"closedAtMs": 1793178900123,
"updatedAt": "2026-10-28T09:15:00.123Z",
"updatedAtMs": 1793178900123,
"limits": {
"minOrderAmount": {
"amount": "100.0000",
"currency": "CZK"
},
"maxOrderAmount": null,
"dailyLimit": {
"amount": "100000.0000",
"currency": "CZK"
},
"dailyLimitRemaining": {
"amount": "94950.0000",
"currency": "CZK"
}
},
"allowedMarkets": [
"BTCCZK",
"ETHCZK"
],
"contact": {
"email": "jana.novakova@example.com",
"phone": "+420777299806"
}
}
}Denní report
Oznámení, že je denní report hotový. Pole data nese souhrn dne, celý report stáhnete přes GET /v1/reports/daily.
report.daily.ready
Denní report za předchozí pražský den je po uzávěrce hotový a už se nemění. Přijde pár minut po uzávěrce dne (ve výchozím nastavení ve 3:00 pražského času) za každý den, i za den bez pokynů a plateb, abyste věděli, že má kontrola proběhnout.
data: Objekt { date, closesAt, closesAtMs, ordersCount, paymentsCount, hasStatement }: date je den reportu (YYYY-MM-DD, hodnota parametru date pro GET /v1/reports/daily), closesAt jeho uzávěrka, ordersCount a paymentsCount počet položek v polích orders a payments reportu a hasStatement, zda report nese denní výpis.
{
"eventId": "0193a1b2-5c3d-7e4f-8a9b-000000000015",
"type": "report.daily.ready",
"occurredAt": "2026-10-28T02:05:00.412Z",
"occurredAtMs": 1793153100412,
"partnerCode": "ABCD",
"data": {
"date": "2026-10-27",
"closesAt": "2026-10-28T02:00:00.000Z",
"closesAtMs": 1793152800000,
"ordersCount": 2,
"paymentsCount": 3,
"hasStatement": false
}
}Služba
Události o údržbě API. Dostane je partner s aktivním cílem, který je odebírá; každý partner má vlastní eventId.
service.maintenance
Začala údržba API, nebo se ohlásilo, změnilo či zrušilo plánované okno údržby, které ještě neskončilo.
data: Objekt { active, plannedFrom, plannedFromMs, plannedUntil, plannedUntilMs, message }: active říká, zda odstávka právě probíhá, meze okna jsou null, když nejsou známé, message je tentýž text jako maintenance.description ve stavu služby.
{
"eventId": "0193a1b2-5c3d-7e4f-8a9b-000000000006",
"type": "service.maintenance",
"occurredAt": "2026-10-28T09:15:00.123Z",
"occurredAtMs": 1793178900123,
"partnerCode": "ABCD",
"data": {
"active": false,
"plannedFrom": "2026-11-07T20:00:00.000Z",
"plannedFromMs": 1794081600000,
"plannedUntil": "2026-11-07T22:00:00.000Z",
"plannedUntilMs": 1794088800000,
"message": "Database upgrade, trading is unavailable"
}
}service.resumed
Údržba skončila a API znovu přijímá požadavky.
data: Objekt { resumedAt, resumedAtMs }.
{
"eventId": "0193a1b2-5c3d-7e4f-8a9b-000000000007",
"type": "service.resumed",
"occurredAt": "2026-10-28T09:15:00.123Z",
"occurredAtMs": 1793178900123,
"partnerCode": "ABCD",
"data": {
"resumedAt": "2026-10-28T09:15:00.123Z",
"resumedAtMs": 1793178900123
}
}Zkušební událost
Posílá se na požádání z POST /v1/webhooks/test.
ping
Zkušební událost z POST /v1/webhooks/test. Posílá se vždy, výběr událostí ji neomezuje.
data: Prázdný objekt.
{
"eventId": "0193a1b2-5c3d-7e4f-8a9b-000000000005",
"type": "ping",
"occurredAt": "2026-10-28T09:15:00.123Z",
"occurredAtMs": 1793178900123,
"partnerCode": "ABCD",
"data": {}
}