Skip to main content
GET
/
cs2
/
v1
/
settlements
Settlement log (cursor-paginated)
curl --request GET \
  --url https://ticktock.bet/cs2/v1/settlements \
  --header 'X-API-Key: <api-key>'
{
  "data": [
    {
      "id": 481234,
      "market_offer_id": "ofr_abc",
      "match_id": "52ef…",
      "previous_status": "pending",
      "new_status": "settled",
      "outcome": "won",
      "settled_by": "engine",
      "is_resettlement": false,
      "created_at": "2026-05-10T18:32:14+00:00"
    }
  ],
  "meta": {
    "count": 1
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.ticktock.bet/llms.txt

Use this file to discover all available pages before exploring further.

​
What it returns

Append-only log of every settlement decision — won / lost / void — with the actor (engine / system / admin), reason, and resettlement flag. Use it for:
  • Reconciliation — daily catch-up against your live AMQP feed.
  • Disputes — historical record of how a market was graded.
  • Resettlements — entries with is_resettlement: true are corrections to previously-settled markets.
Cursor pagination via ?since_id=<cursor>. The id field on the most recent entry becomes the next call’s cursor.

​
Required scope

  • Minimum: cs2:markets:settlements

​
Reconciliation pattern

import requests, time
BASE = "https://ticktock.bet/cs2/v1"
last_id = None
while True:
    params = {"limit": 100}
    if last_id: params["since_id"] = last_id
    resp = requests.get(f"{BASE}/settlements", headers={"X-API-Key": TT_KEY}, params=params)
    for entry in resp.json()["data"]:
        process_settlement(entry)
        last_id = entry["id"]
    time.sleep(30)
See Settlement for the full reconciliation guide.

Authorizations

​
X-API-Key
string
header
required

Tenant API key issued during onboarding

Query Parameters

​
limit
integer
default:50
Required range: 1 <= x <= 200
​
since_id
string<uuid> | null

Cursor: return entries created after this ID.

Response

Successful Response

The response is of type Response List Settlements Cs2 V1 Settlements Get · object.

Last modified on May 10, 2026