Skip to main content
GET
/
v1
/
tokens
/
portfolio
/
:address
Get Portfolio
curl --request GET \
  --url https://api.example.com/v1/tokens/portfolio/:address
{
  "array": [
    {
      "id": "<string>",
      "chainId": 123,
      "address": "<string>",
      "tokenId": "<string>",
      "amount": "<string>",
      "updatedAt": "<string>",
      "tokenMetadata": {}
    }
  ]
}

​
Overview

Retrieve the portfolio of ERC-1155 tokens held by a specific wallet address. Returns all token positions with their metadata.

​
Path Parameters

​
address
string
required
The wallet address to get the portfolio for (smart wallet address)

​
Query Parameters

​
chainId
string
Optional chain ID. Defaults to 8453 (Base) if not provided.

​
Response

​
array
array
required
Array of portfolio items
[
  {
    "id": "1",
    "chainId": 8453,
    "address": "0xabcdef1234567890...",
    "tokenId": "0x1234567890abcdef...",
    "amount": "10.5",
    "updatedAt": "2024-01-15T10:00:00.000Z",
    "tokenMetadata": {
      "name": "BTC-100K-2024-12 - yes",
      "description": "Position token for market BTC-100K-2024-12",
      "image": "...",
      "decimals": 0,
      "properties": {
        "marketId": "BTC-100K-2024-12",
        "outcome": "yes",
        "tokenId": "0x1234567890abcdef..."
      }
    }
  }
]