List rounds

Rounds by playerId, gameId, from, to

GET/v1/rounds

Request

A client sends this request signed with its credential. The example is signed with the test API key test-key-test-key and the test secret docs-example-signing, at the timestamp 1767225600 with the nonce docs-example-nonce-0001; see Authentication and signing.

Headers

Name
X-Api-Key
Type
string, required
Description
The credential id. Sent together with X-Timestamp, X-Nonce and X-Signature.
Name
X-Signature
Type
string, required
Description
Base64 HMAC-SHA256 of the method, the path with its query, X-Timestamp, X-Nonce and the lowercase hex SHA-256 of the raw body, joined by newlines. Compared in constant time; 30 seconds of tolerance; each nonce is used once.
Name
X-Timestamp
Type
string, required
Description
Unix seconds; within 30 seconds of the receiver's clock. Matches ^[0-9]{1,12}$.
Name
X-Nonce
Type
string, required
Description
Single use per credential, kept until the timestamp plus 30 seconds. At least 16 characters. At most 128 characters.

Query parameters

Name
playerId
Type
string
Description
The client's own player id, at most 44 characters so that every provider can carry it namespaced. At least 1 character. At most 44 characters.
Name
gameId
Type
string (uuid)
Description
A UUID v7.
Name
from
Type
string (date-time)
Description
Inclusive start.
Name
to
Type
string (date-time)
Description
Exclusive end.
Name
cursor
Type
string
Description
The opaque next_cursor of the previous page. At least 1 character. At most 512 characters.
Name
limit
Type
integer
Description
At least 1. At most 200. Defaults to 50.

Request

GET

/v1/rounds

curl "https://aggregator.asteriks.casino/v1/rounds?playerId=player-1001&limit=50" \
  -H "X-Api-Key: test-key-test-key" \
  -H "X-Timestamp: 1767225600" \
  -H "X-Nonce: docs-example-nonce-0001" \
  -H "X-Signature: YCgItxpOS+nkxUZ/UMza5mRGDvpsTbjHpgNgt0Av04U="

200

Response

The answer is 200 with application/json.

Name
items
Type
object[], required
Description
Name
items[].round_id
Type
string (uuid), required
Description
A UUID v7.
Name
items[].provider_round_id
Type
string, required
Description
Name
items[].provider
Type
string, required
Description
One of drakon, cocktail, games360.
Name
items[].game_id
Type
string (uuid), required
Description
A UUID v7.
Name
items[].player_id
Type
string, required
Description
The client's own player id, at most 44 characters so that every provider can carry it namespaced. At least 1 character. At most 44 characters.
Name
items[].currency
Type
string, required
Description
One of TRY, EUR, USD, USDT, TON, BTC, AED, AFN, ALL, AMD, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BOV, BRL, BSD, BTN, BWP, BYN, BZD, CAD, CDF, CHE, CHF, CHW, CLF, CLP, CNY, COP, COU, CRC, CUP, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ERN, ETB, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRU, MUR, MVR, MWK, MXN, MXV, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLE, SOS, SRD, SSP, STN, SVC, SYP, SZL, THB, TJS, TMT, TND, TOP, TTD, TWD, TZS, UAH, UGX, USN, UYI, UYU, UYW, UZS, VED, VES, VND, VUV, WST, XAF, XCD, XCG, XOF, XPF, YER, ZAR, ZMW, ZWG.
Name
items[].opened_at
Type
string (date-time), required
Description
Name
items[].closed_at
Type
string (date-time) | null, required
Description
Name
items[].bet_total
Type
integer, required
Description
Minor units of the currency. At least 0. At most 9007199254740991.
Name
items[].win_total
Type
integer, required
Description
Minor units of the currency. At least 0. At most 9007199254740991.
Name
next_cursor
Type
string | null, required
Description
Null on the last page.

Errors

Each error carries one of these codes in the error object of Errors.

Name
MALFORMED_REQUEST
Type
400
Description
MALFORMED_REQUEST: a body, query or path value fails its schema.
Name
UNAUTHORIZED
Type
401
Description
UNAUTHORIZED: a missing or wrong key, signature, timestamp or nonce.
Name
INTERNAL_ERROR
Type
503
Description
INTERNAL_ERROR, retryable: the page waits until every journal entry or round up to its horizon is committed or rolled back, and one still open after the read's bound refuses the whole page rather than answer part of it. Repeat the same request after Retry-After. Retry-After: The whole seconds to wait before repeating the request. Cache-Control: A refusal is never cached.

Response

{
  "items": [
    {
      "round_id": "0199c5a0-0000-7000-8000-000000000003",
      "provider_round_id": "round-7731",
      "provider": "drakon",
      "game_id": "0199c5a0-0000-7000-8000-000000000002",
      "player_id": "player-1001",
      "currency": "EUR",
      "opened_at": "2026-10-13T12:00:00Z",
      "closed_at": "2026-10-13T12:00:05Z",
      "bet_total": 2500,
      "win_total": 5000
    }
  ],
  "next_cursor": null
}