API för utvecklare
Sluta fråga, vi säger till
Registrera en URL och välj händelser. Vi skickar en signerad POST inom några sekunder efter varje ändring och försöker igen i upp till 24 timmar om det misslyckas.
Händelser
rate.updatedEn valutakurs ändrades hos någon bankrate.best_changedLägsta säljkurs eller högsta köpkurs ändradesrate.threshold_crossedEn kurs passerade en gräns du har sattcbe.rate_changedCentralbankens kurs ändradesgold.updatedGuldpriserna ändradessilver.updatedSilverpriserna ändradestransfer.quotes_updatedPriserna hos överföringstjänster ändradescertificate.createdEn bank lanserade ett nytt sparbeviscertificate.rate_changedAvkastningen på ett sparbevis ändradestbill.auction_resultEtt resultat från en auktion av statsskuldväxlarfund.price_updatedEn fonds andelskurs uppdateradesstatus.incidentEn driftstörning började eller tog slutVad vi skickar
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 }
}
}Kontrollera signaturen
Varje anrop signeras med adressens hemlighet med HMAC SHA-256. Avvisa allt som är äldre än 5 minuter.
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));
}Leverans och omförsök
- Tidsgräns
- Svara med 2xx inom 10 sekunder
- Omförsök
- 8 försök under 24 timmar, med längre uppehåll varje gång
- Dubbletter
- En händelse kan komma två gånger, så använd dess id för att hoppa över upprepningar
- Ordning
- Jämför created_at, eftersom ordningen inte garanteras
- Paus
- Vi pausar en adress efter 3 dagar med fel och mejlar dig, och du kan skicka om det du missat
Dina adresser
Webhookar är på vägDu lägger till adresser här när webhookar öppnar. De ingår i Pro och uppåt.
Kommer snart