Get Prediction Balances

Fetch on-chain ConditionalTokens (ERC-1155) balances for a wallet’s Safe trading account.

GET /2/wallet/pm/balances

Get Prediction Balances

cURL

curl --request GET \
  --url https://pm-api-prod-eu.mobula.io/api/2/wallet/pm/balances

200

{
  "data": {}
}

Alpha — This endpoint is part of the Prediction Markets API, currently in early access. May change without notice.

Query Parameters

wallet · string · required

The wallet address (EOA). The Safe address is derived automatically.

tokenIds · string · required

Comma-separated list of outcome token IDs to check balances for.

Response

data · object

Balance information for the requested outcome tokens.

Show Balances

safeAddress · string

The Safe trading account address.

balances · array

Array of token balance objects.

Show Balance

tokenId · string

The ERC-1155 outcome token ID.

balance · number

Token balance (in token units, 6 decimal precision).

hostname · string

Server node identifier.

took · number

Request processing time in milliseconds.

Usage Example

curl -X GET "https://api.mobula.io/api/2/wallet/pm/balances?wallet=0xYourWallet&tokenIds=71321...,48340..."

Example Response

{
  "data": {
    "safeAddress": "0x1234567890abcdef1234567890abcdef12345678",
    "balances": [
      { "tokenId": "71321...", "balance": 5.5 },
      { "tokenId": "48340...", "balance": 0 }
    ]
  },
  "hostname": "node-xyz",
  "took": 42
}

Balances are read directly from the ConditionalTokens ERC-1155 contract on Polygon via multicall. A balance of 5.5 means the Safe holds 5.5 outcome tokens (shares). These tokens pay out $1 each if the outcome wins.

Query Parameters

wallet · string · required

User EOA wallet address. The API resolves the matching Safe trading account internally.

Example:

"0x0000000000000000000000000000000000000001"

tokenIds · string · required

Comma-separated outcome / token IDs (uint256 decimal strings).

Example:

"59855952379545476461266875939089074481171378466995213858930892770855011813551,5904694069529905826680225678119990013628860098514322777023141327768111791078"

Response

200 - application/json

Balances

data · object