Getting Started

This guide will help you get up and running with the API quickly.

Base URL

The API is available at:

• Production: https://api.b337.ai

Required Headers

All API requests must include the following headers:

Content-Type: application/json
X-API-Key: YOUR_API_KEY

Authentication

The API uses API key authentication. You'll need to:

1. Obtain an API key from your account dashboard
2. Include the API key in the X-API-Key header of every request
3. Keep your API key secure and never commit it to version control

See the Authentication guide for detailed information.

Making Your First Request

Let's start with a simple health check or account information request:

Using cURL

curl -X POST https://api.b337.ai/api/session_ids \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Using Python

import requests

headers = {
    'X-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
}

response = requests.post(
    'https://api.b337.ai/api/session_ids',
    headers=headers
)

print(response.json())

Response Format

API responses vary by endpoint:

Success Response (Place Bet):

{
  "success": true,
  "bet_id": "bet-uuid",
  "bookie_bet_id": "bookie-specific-id",
  "stake": 10.0,
  "odds": 3.5,
  "potential_return": 35.0,
  "status": "placed"
}

Success Response (Get Sessions):

{
  "sessions": [
    {
      "session_id": "uuid-string",
      "bookie": "tab",
      "username": "user@example.com",
      "active": true
    }
  ]
}

Error Response:

{
  "detail": "Error message describing what went wrong"
}

Next Steps

• Learn about Authentication - Understand how to securely authenticate
• Make Your First Request - Step-by-step guide to your first API call
• Explore Sessions - Learn about open sessions (sessions with no strategy attached)