Skip to main content
GET
/
v1
/
accounts
/
{account_id}
/
balances
Get Account Balances
curl --request GET \
  --url https://api.predictamarkets.com/v1/accounts/{account_id}/balances \
  --header 'X-Api-Key: <api-key>'
{
  "currency": "KES",
  "suspense": "200.00",
  "available": "4300.00",
  "portfolio": "0.00"
}

Documentation Index

Fetch the complete documentation index at: https://docs.predictamarkets.com/llms.txt

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

Authorizations

​
X-Api-Key
string
header
default:your-api-key-here
required

Path Parameters

​
account_id
required

Flexible identifier type that accepts either a numeric integer ID or a human-readable qualified ID string (QID). QIDs follow a prefix convention: MA for markets, MAA for market assets, AP for account payouts. Most path parameters that accept an ID use this type so callers can use whichever form is more convenient.

Response

Balance breakdown

Real-time balance breakdown for an account, split into three components that sum to the account's total holdings.

​
currency
enum<string>
required

Currency of the account. Usually PT (Predicta Token) for standard accounts. Real-currency accounts show a fiat or crypto code.

Available options:
NGN,
USD,
KES,
GHS,
ZAR,
XOF,
TZS,
EUR,
GBP,
CAD,
AUD,
CHF,
CNY,
INR,
MXN,
NZD,
RUB,
SEK,
SGD,
THB,
TRY,
UAH,
VND,
JPY,
UGX,
RWF,
USDC,
USDT,
PT
​
suspense
string
required

Funds currently held in escrow due to open (unmatched) orders. When you place a BUY order, price x quantity is moved from available to suspense. Suspense is released if the order is cancelled, or converted to portfolio value when filled.

Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
​
available
string
required

Spendable balance — funds that are free to use for new orders or withdrawals. Calculated as total balance minus suspense.

Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
​
portfolio
string
required

Current value of all open (filled) positions across all markets. Increases when YES prices rise on your holdings; decreases when they fall. Does not include suspense.

Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$