Get started

Quickstart

Five steps from zero to a working GET call against betspread.

  1. 1. Request beta access

    Reach out via Contact and confirm bookmaker, sport, market, and region scope. We enable your organisation manually during controlled beta.

  2. 2. Create an API key

    Once access is enabled, open API keys in the dashboard and create a key. The full secret is shown once at creation — store it in a secret manager and rotate it from the dashboard.

  3. 3. Set the BETSPREAD_API_KEY env var

    Export your key into the environment so the samples below pick it up automatically:

    Shell
    export BETSPREAD_API_KEY="bapi_xxxxxxxxx"

  4. 4. Run your first request

    Call /api/v1/sports to discover what your key can see:

    List sports
    curl "https://api.betspread.io/api/v1/sports" \
  -H "Authorization: Bearer $BETSPREAD_API_KEY"

  5. 5. Next steps