Transactions API

Retrieve normalized transaction history including settled bets, pending bets, and account activity.

Base URL: https://api.b337.ai

POST /v3/transactions is the new home for this endpoint. It uses the same async contract as /v3/place_bet: a 202 response in ~100ms with a correlation_id, then poll /api/bet_status (or receive a signed webhook at callback_url) for the actual transaction list. The result payload is identical to what GET /v2/transactions returned synchronously - so existing parsing code only needs to know where to read it from.

The method changed from GET (query params) to POST (JSON body) so that the v3 endpoint can accept callback_url - same convention as every other v3 endpoint.

---

Get Transactions - POST /v3/transactions {#v3-transactions}

Request

{
  "session_id": "uuid",
  "days_back": 7,
  "limit": 20
}

Response (202)

Standard v3 async envelope:

{
  "status":         "pending",
  "correlation_id": "9b3c…uuid…",
  "session_id":     "uuid",
  "bookie":         "tab",
  "username":       "user@example.com",
  "submitted_at":   "2026-05-14T10:00:00.000Z",
  "timeout_at":     "2026-05-14T10:05:00.000Z",
  "callback_url":   null
}

Retrieve the result by polling POST /api/bet_status with the correlation_id, or via webhook if you passed callback_url. Signature verification, retry behaviour, and status values are identical to every other v3 endpoint - see the Async API (v3) guide.

The polling endpoint /api/bet_status works for any correlation_id - place_bet, withdraw-balance, price_check, transactions.

result payload

The result field on the poll response (and the webhook body) carries exactly what /v2/transactions used to return inline:

{
  "success": true,
  "transactions": [
    {
      "id": "bet_12345678",
      "type": "bet",
      "status": "won",
      "stake": 10.00,
      "odds": 3.50,
      "pnl": 25.00,
      "is_bonus_bet": false,
      "placed_at": "2026-02-03T10:00:00Z",
      "settled_at": "2026-02-03T12:30:00Z",
      "selections": [
        {
          "event": "Flemington R3",
          "selection": "Horse Name",
          "market": "win",
          "odds": 3.50,
          "result": "won"
        }
      ]
    },
    {
      "id": "bet_12345679",
      "type": "bet",
      "status": "lost",
      "stake": 5.00,
      "odds": 2.10,
      "pnl": -5.00,
      "is_bonus_bet": true,
      "placed_at": "2026-02-03T09:00:00Z",
      "settled_at": "2026-02-03T11:00:00Z",
      "selections": [
        {
          "event": "Randwick R1",
          "selection": "Another Horse",
          "market": "place",
          "odds": 2.10,
          "result": "lost"
        }
      ]
    },
    {
      "id": "bet_12345680",
      "type": "bet",
      "status": "pending",
      "stake": 20.00,
      "odds": 4.50,
      "pnl": 0,
      "is_bonus_bet": false,
      "placed_at": "2026-02-03T14:00:00Z",
      "settled_at": null,
      "selections": [
        {
          "event": "Caulfield R5",
          "selection": "Fast Runner",
          "market": "win",
          "odds": 4.50,
          "result": "pending"
        }
      ]
    }
  ],
  "total_count": 45,
  "has_more": true
}

Transaction object

Selection object

Response field reference (in result)

Status values

---

Example: fetch recent transactions (Python, polling)

import requests, time

API_KEY = "your-api-key"
BASE_URL = "https://api.b337.ai"
HEADERS = {"X-API-Key": API_KEY, "Content-Type": "application/json"}

# 1. Submit (202 in ~100ms)
submit = requests.post(
    f"{BASE_URL}/v3/transactions",
    headers=HEADERS,
    json={"session_id": "uuid", "days_back": 7, "limit": 20},
).json()

cid = submit["correlation_id"]
timeout_at = submit["timeout_at"]
deadline = time.mktime(time.strptime(timeout_at[:19], "%Y-%m-%dT%H:%M:%S"))

# 2. Poll /api/bet_status until done
while time.time() < deadline:
    r = requests.post(
        f"{BASE_URL}/api/bet_status",
        headers=HEADERS,
        json={"correlation_ids": [cid]},
    ).json()
    entry = r["statuses"][0]
    if entry["status"] == "completed":
        payload = entry["result"]
        # Calculate stats - payload shape is identical to /v2/transactions
        txns = payload["transactions"]
        total_pnl = sum(t["pnl"] for t in txns)
        wins = sum(1 for t in txns if t["status"] == "won")
        losses = sum(1 for t in txns if t["status"] == "lost")
        pending = sum(1 for t in txns if t["status"] == "pending")
        print(f"P&L: ${total_pnl:+.2f}")
        print(f"Record: {wins}W - {losses}L ({pending} pending)")
        break
    if entry["status"] in ("timeout", "unknown"):
        print(f"Failed: {entry['status']}")
        break
    time.sleep(2)

---

Deprecated: GET /v2/transactions

⚠️ Deprecated - sunset 2026-05-17. GET /v2/transactions still works but now returns deprecation response headers:

Deprecation: true
Sunset: Sun, 17 May 2026 00:00:00 GMT
Link: </v3/transactions>; rel="successor-version"

After 17 May 2026 it will return HTTP 410. Migrate to POST /v3/transactions - same payload shape, just wrapped in the async envelope. Note the method changed from GET to POST and the params moved from query string to JSON body.

Request (legacy)

GET /v2/transactions?session_id=xxx&days_back=7&limit=20

Response (legacy)

Returns the same payload shape shown under result payload above, but inline in the HTTP response body (no correlation_id / no poll step).

cURL (legacy)

curl -X GET "https://api.b337.ai/v2/transactions?session_id=xxx&days_back=7&limit=20" \
  -H "X-API-Key: your-api-key"

---

Next Steps

• Async API (v3) guide - Polling and webhook semantics
• Place Bet - Place racing & sports bets
• Bonus Bets - Manage bonus bet tokens