List rounds
Rounds by playerId, gameId, from, to
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. An RFC 3339 date-time with an offset and at most 3 fractional second digits. A UTC time outside the years 0100 to 9999, with the offset applied first, is 400 MALFORMED_REQUEST. Matches
^\d{4}-\d{2}-\d{2}[Tt]\d{2}:\d{2}:\d{2}(?:\.\d{1,3})?(?:[Zz]|[+-]\d{2}:\d{2})$.
- Name
to- Type
- string (date-time)
- Description
Exclusive end. An RFC 3339 date-time with an offset and at most 3 fractional second digits. A UTC time outside the years 0100 to 9999, with the offset applied first, is 400 MALFORMED_REQUEST. Matches
^\d{4}-\d{2}-\d{2}[Tt]\d{2}:\d{2}:\d{2}(?:\.\d{1,3})?(?:[Zz]|[+-]\d{2}:\d{2})$.
- Name
cursor- Type
- string
- Description
The opaque next_cursor of the previous page, sent back unchanged by the client it was given to. A history cursor is sealed for that client: another client's cursor, or one changed in any byte, is 400 MALFORMED_REQUEST. A history cursor is also bound to the filters of the page that returned it (limit, from, to, playerId, gameId). It expires one hour after that page. A cursor sent with other filters, or later, is the same 400 MALFORMED_REQUEST. A new first page starts the list again. At least 1 character. At most 512 characters.
- Name
limit- Type
- integer
- Description
At least 1. At most 200. Defaults to
50.
Request
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="
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,betting_software,electrobets.
- 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
Gross of reversals: the sum of the round's acknowledged bets in minor units. A bet that was rolled back stays counted here; its reversal is a separate entry of the round, summed in rollback_total. At least 0. At most 9007199254740991.
- Name
items[].win_total- Type
- integer, required
- Description
Gross of reversals: the sum of the round's acknowledged wins in minor units. A win that was rolled back stays counted here; its reversal is a separate entry of the round, summed in rollback_total. At least 0. At most 9007199254740991.
- Name
items[].rollback_total- Type
- integer, required
- Description
Gross: the sum of the round's acknowledged rollbacks in minor units. Each is counted once at what it reversed of a counted bet or win and never netted into bet_total or win_total. An entry's refers_to_transaction_id names what it reversed. An aggregator compensation moves no total. 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 is retryable. The page waits until every journal entry or round up to its horizon is committed or rolled back. 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,
"rollback_total": 0
}
],
"next_cursor": null
}