BANKROLL API · v1
Embed sports betting into your app.
Odds, markets, bet placement and settlement through one REST API. You own the interface — we handle pricing, wallets, licensing and payouts.
Email us for access →i@heybankroll.com
Private beta · base URL and API key issued together · usually same-day
POST /v1/bets
// Server-side TypeScript (Node 18+)
const apiUrl = process.env.BANKROLL_API_URL?.replace(/\/$/, "");
const apiKey = process.env.BANKROLL_API_KEY;
if (!apiUrl || !apiKey) {
throw new Error("Missing Bankroll API configuration");
}
// Reuse this key if the same request is retried.
const idempotencyKey = crypto.randomUUID();
const response = await fetch(`${apiUrl}/v1/bets`, {
method: "POST",
headers: {
Authorization: `Bearer ${apiKey}`,
"Content-Type": "application/json",
"Idempotency-Key": idempotencyKey,
},
body: JSON.stringify({
user_id: "usr_8f21c4",
selection_id: "sel_01J8QF3M7R2K",
stake: {
amount: 240000, // minor units: ₦2,400.00
currency: "NGN",
},
min_decimal_odds: 1.8,
}),
});
const result = await response.json();
if (!response.ok) {
throw new Error(result.message ?? `Bankroll API error ${response.status}`);
}
console.log(result.bet.id, result.bet.status);
// → bet_01J8QG4D8K9M "accepted"Server-side examples · Never expose secret keys in browser or mobile code.
01
Bet on our licence
Ship in a regulated market without holding a licence yourself. KYC, limits and cool-offs come with the endpoint.
02
Odds and pricing included
Live prices across every major league, plus our own fair-value model on the same object — so you can flag when a price is too generous.
03
Wallets, payouts, settlement
Naira transfers, USDC and crypto in and out. Bets settle automatically and a webhook tells you the moment they do.
04
Set your own margin
You pay a flat fee on stakes. What you charge your users is yours to decide — add your margin on top and keep the difference.
Keys are issued by hand while we're in private beta. Tell us what you're building and we'll send one over — plus the docs.
i@heybankroll.com →Bankroll is a licensed sports betting operator in Nigeria. Betting involves risk — wins are never guaranteed. 18+. Integrations are subject to review and responsible-play requirements.