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
// 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.