Skip to main content
GET
/
2
/
wallet
/
pm
/
balances
Wallet outcome balances (by tokenIds CSV)
curl --request GET \
  --url https://demo-api.mobula.io/api/2/wallet/pm/balances
{
  "data": {
    "safeAddress": "<string>",
    "balances": [
      {
        "tokenId": "<string>",
        "balance": "<string>"
      }
    ]
  },
  "hostname": "<string>",
  "took": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.mobula.io/llms.txt

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

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.
​
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
Minimum string length: 1
​
tokenIds
string
required

Comma-separated outcome / token IDs.

Minimum string length: 1

Response

200 - application/json

Prediction Markets response

​
data
object
required
​
hostname
string
required
​
took
number
required