For developers
Webhooks and API
Hook your own bot, website or tools to what happens in your Discord server on Rally. Set it up in the server panel under Webhooks and API (the settings part of the team).
Webhooks
Rally sends a POST with a JSON body to your https link for every event you ticked. Answer with any 2xx within 5 seconds; there are no retries, and the panel shows the last deliveries. A test from the panel sends the event ping.
rumble.ended· A Rumble ended: winner, top 3, players, prize and the replay linkboss.defeated· The weekly boss was defeated: who did the most damage and the Shells sharedduel.played· A server duel was played: both scores and the winnerpool.paid· Prizes from one of the server's pools were paid on VeChain
{
"event": "rumble.ended",
"guildId": "123456789012345678",
"at": "2026-11-16T20:15:00.000Z",
"data": {
"rumbleId": "cm…",
"mode": "classic",
"players": 24,
"winner": { "discordId": "…", "name": "Shelly", "kills": 4, "registered": true },
"top": [{ "place": 1, "discordId": "…", "name": "Shelly", "kills": 4 }],
"prize": null,
"poolPrizes": [{ "discordId": "…", "name": "Shelly", "reason": "place", "amount": "60", "symbol": "B3TR", "weeks": 0 }],
"duelId": null,
"replay": "https://rally.blackvemarket.com/rumble/r/cm…",
"winnerCard": "https://rally.blackvemarket.com/rumble/w/cm…"
}
}Check the signature
Every call has X-Rally-Event, X-Rally-Timestamp and X-Rally-Signature: sha256= and the HMAC-SHA256 of timestamp.body with your secret. Check it on the raw body, and refuse old timestamps.
// Node: check that a webhook call came from Rally
import crypto from "node:crypto";
function fromRally(rawBody, headers, secret) {
const timestamp = headers["x-rally-timestamp"];
const expected = "sha256=" + crypto.createHmac("sha256", secret).update(`${timestamp}.${rawBody}`).digest("hex");
const given = String(headers["x-rally-signature"] || "");
const fresh = Math.abs(Date.now() / 1000 - Number(timestamp)) < 300;
return fresh && given.length === expected.length && crypto.timingSafeEqual(Buffer.from(given), Buffer.from(expected));
}Read API
GET /api/public/servers/<server id> returns the last 20 Rumbles (with replay links), the top winners of the last 30 days, this week's boss and the prize pools. Servers on the public server list are open to anyone; any other server needs its secret as an API key.
curl -H "Authorization: Bearer rk_…" https://rally.blackvemarket.com/api/public/servers/123456789012345678
Giveaways promoted on BlackVeMarket are at GET /api/public/giveaways. Keep the key secret: a new one from the panel stops the old one right away.
A wallet's reputation, for any project or dApp, no key needed: GET /api/public/reputation/<wallet> gives its trust score, level, giveaways joined, tasks approved and the share rejected, wins, and a verdict (trusted, active, new, careful, blocked or unknown).
curl https://rally.blackvemarket.com/api/public/reputation/0x…