GET /api/v1/partner/balance

Returns the partner's balances: the undistributed funds on the float account, the combined balance of the partner's user sub-accounts, and their total.

Authentication

Required. Partner API key in X-Partner-Key header.

Request

No parameters.

Example

curl https://api.intotes.com/api/v1/partner/balance \
  -H "X-Partner-Key: <partner_key>"

Response

200 OK

All amounts are integers in kopecks, where 100 kopecks equal 1 RUB. See Money Format.

{
  "partner": "acme casino",
  "float_balance_kopecks": 4500000,
  "users_balance_kopecks": 1230000,
  "total_kopecks": 5730000
}

Response Fields

Field	Type	Description
partner	string	Name of the partner the API key belongs to.
float_balance_kopecks	int	The partner's undistributed funds on the float account.
users_balance_kopecks	int	Combined balance of all of the partner's user sub-accounts.
total_kopecks	int	Sum of float_balance_kopecks and users_balance_kopecks.

Notes

• Each bet stake is funded from float_balance_kopecks. When it does not cover the stake, Place Bet returns INSUFFICIENT_FLOAT and the float account has to be topped up.
• A sell payout stays on the user's sub-account, so it is counted in users_balance_kopecks, not in float_balance_kopecks. See Sell Position.
• The per-user breakdown behind users_balance_kopecks is available from Get User State.

Errors

No endpoint-specific error codes are documented for this endpoint. The authentication errors shared by every partner endpoint are listed in the Overview, and the full catalogue is in Error Handling.