Získat API klíč
Přehled API · Webhooky

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.

Těla níže skládá týž kód, který je posílá, a uložený soubor ukázek hlídá test stability kontraktu, takže se změna tvaru objektu pokynu nebo subúčtu projeví i tady. Hodnoty (identifikátory, částky, časy) jsou ilustrační.

Obálka

PolePopis
eventIdstringIdentifikátor události (UUID), shodný s hlavičkou X-COINERO-EVENT-ID. Podle něj deduplikujte: doručení je alespoň jednou.
typestringTyp události, viz níže. Nové typy mohou v rámci v1 přibýt; neznámý typ zpracujte bez selhání.
occurredAtstringOkamžik vzniku události, ISO 8601, UTC. Podle něj a podle stavu v data řaďte, pořadí doručení není zaručené.
occurredAtMsintegerStejný okamžik jako Unix timestamp v milisekundách.
partnerCodestringKód vašeho partnerského účtu.
dataobjectPř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": {}
}