API для розробників

Не опитуйте, ми повідомимо самі

Зареєструйте URL і виберіть події. Ми надішлемо підписаний POST за кілька секунд після кожної зміни й повторюватимемо до 24 годин у разі збою.

Події

rate.updatedКурс валюти змінився в одному з банків
rate.best_changedЗмінилася найнижча ціна продажу або найвища ціна купівлі
rate.threshold_crossedКурс перетнув заданий вами поріг
cbe.rate_changedЗмінився курс Центробанку
gold.updatedЗмінилися ціни на золото
silver.updatedЗмінилися ціни на срібло
transfer.quotes_updatedЗмінилися ціни сервісів переказів
certificate.createdБанк випустив новий сертифікат
certificate.rate_changedЗмінилася дохідність сертифіката
tbill.auction_resultРезультат аукціону казначейських векселів
fund.price_updatedОновилася ціна паю фонду
status.incidentЗбій сервісу почався або закінчився

Що ми надсилаємо

POST https://example.com/geneh
Geneh-Event: rate.best_changed
Geneh-Signature: t=1792118220,v1=5f2b9c1e7a

{
  "id": "evt_01JB7Q2K",
  "type": "rate.best_changed",
  "created_at": "2026-10-16T00:37:00Z",
  "data": {
    "currency": "USD",
    "side": "sell",
    "previous": { "bank": "nbe", "rate": 53.52 },
    "current": { "bank": "credit_agricole", "rate": 53.47 }
  }
}

Перевірка підпису

Кожен запит підписано секретом вашої адреси за HMAC SHA-256. Відхиляйте все, що старше за 5 хвилин.

import crypto from "node:crypto";

function verify(rawBody, header, secret) {
  const [t, v1] = header.split(",").map(p => p.split("=")[1]);
  const mac = crypto.createHmac("sha256", secret)
    .update(t + "." + rawBody).digest("hex");
  const fresh = Math.abs(Date.now() / 1000 - t) < 300;
  return fresh && crypto.timingSafeEqual(Buffer.from(mac), Buffer.from(v1));
}

Доставка та повтори

Тайм-аут
Відповідайте кодом 2xx протягом 10 секунд
Повтори
8 спроб за 24 години зі зростаючим інтервалом
Дублікати
Подія може прийти двічі, тож пропускайте повтори за її id
Порядок
Порівнюйте created_at, бо порядок не гарантовано
Призупинення
Після 3 днів збоїв ми призупиняємо адресу й пишемо вам листа, а пропущене можна надіслати повторно

Ваші адреси

Вебхуки вже незабаромТут можна буде додати адреси, коли відкриються вебхуки. Вони входять у Pro і вище.
Незабаром