Message Format - AnySport

Generic Client Request Structure

Every client request — regardless of which product it targets — follows the same top-level shape.

Field	Required	Type	Notes
`code`	Required	int	Operation type — see the message code table below
`trace`	Required	string	Client-generated trace ID (a UUID is recommended); echoed back verbatim by the server
`data`	Conditionally required	object	Required for subscribe requests (can be `{}`); can be omitted for heartbeats and unsubscribes

Generic client request structure

{
  "code": 20000,
  "trace": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "data": {}
}

Field	Required	Type	Notes
`code`	Yes	int	Success code or error code
`trace`	Yes	string	Matches the request’s `trace` (may be empty if the request didn’t include one)
`msg`	Yes	string	`ok` on success; an error description on failure

{
  "code": 20001,
  "trace": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "msg": "ok"
}

{
  "code": 40301,
  "trace": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "msg": "error description"
}

Field	Required	Type	Notes
`type`	Yes	string	Always `error`
`message`	Yes	string	Reason, e.g. heartbeat timeout or rate limiting

Websocket connection error example

{
  "type": "error",
  "message": "request frequency limit exceeded (60/min)"
}

Applies to all products’ subscribe requests (20000 / 20200 / 20100 / 20300).

Field	Required	Type	Notes
`api_key`	Conditionally required	string	Required if `api_key` wasn’t included in the handshake URL; otherwise optional
`match_id`	Optional	string	Only receive pushes for this match; omit or pass `null` to receive all pushes for this product
`league_id`	Optional	string	League filter (optional extension field)
`country_id`	Optional	string	Country filter (optional extension field)

Notes:

Sending the same product’s subscribe code again overwrites the old filter — no reconnect needed.
A failed subscribe request (e.g. no entitlement, expired plan) returns 40301 without dropping the connection — fix your parameters and retry.

Field	Required	Type	Notes
`code`	Required	int	The unsubscribe code for the relevant product
`trace`	Required	string	Trace ID
`data`	Optional	object	Can be omitted

Code	Description	Required fields
`20000`	Subscribe to Live Match Stats	`code`, `trace`, `data`
`20200`	Subscribe to Score	`code`, `trace`, `data`
`20100`	Subscribe to In-Play Odds	`code`, `trace`, `data`
`20300`	Subscribe to Pre-match Odds	`code`, `trace`, `data`
`21000`	Unsubscribe from Live Match Stats	`code`, `trace`
`21200`	Unsubscribe from Score	`code`, `trace`
`21100`	Unsubscribe from In-Play Odds	`code`, `trace`
`21300`	Unsubscribe from Pre-match Odds	`code`, `trace`
`20010`	Heartbeat	`code`, `trace`

Code	Description
`20001` / `20201` / `20101` / `20301`	Subscribe succeeded for the corresponding product
`21010` / `21210` / `21110` / `21310`	Unsubscribe succeeded for the corresponding product
`40001`	Message is not valid JSON
`40002`	Missing required field (`code` / `trace` / `data` / `api_key`)
`40003`	Invalid parameter or unknown code
`40301`	No entitlement, or your plan doesn’t cover this product

type	Description
`connected`	Handshake succeeded
`situation_update`	Live Match Stats push
`score_update`	Score push
`odds_live_update`	In-Play Odds push
`odds_prematch_update`	Pre-match Odds push
`error`	Connection-level error (heartbeat timeout, rate limiting, etc.)