Portfolio API — View Holdings, Values, and PnL Data

Query current token holdings, USD values, and PnL across connected wallets, or pull historical portfolio snapshots with the Big Brain Ape Portfolio API.

The Portfolio API gives you a real-time snapshot of every token you hold across your connected wallets. Use it to retrieve current balances, USD values, and profit-and-loss figures by network, or pull historical portfolio data to track how your holdings have changed over time.

GET /portfolio

Retrieve all current token holdings across your connected wallets. Results include per-token amounts, USD values, and PnL percentages.

Required scope: read

Query Parameters

network · string

Filter holdings by blockchain network. Accepted values: solana, ethereum, base, arbitrum. Omit to return holdings from all connected networks.

currency · string · default: "USD"

The fiat currency used for value calculations. Defaults to USD.

Example Request

curl -X GET 'https://api.bigbrainape.com/v1/portfolio?currency=USD' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Example Response

{
  "success": true,
  "data": {
    "totalValue": 12450.50,
    "currency": "USD",
    "change24h": 3.42,
    "holdings": [
      {
        "token": "SOL",
        "amount": "15.5",
        "valueUSD": 2232.50,
        "pnlPercent": 12.4,
        "network": "solana"
      },
      {
        "token": "ETH",
        "amount": "2.1",
        "valueUSD": 6720.00,
        "pnlPercent": -2.1,
        "network": "ethereum"
      }
    ]
  },
  "timestamp": "2024-01-15T14:32:00Z"
}

Response Fields

success · boolean

true when the request completes without errors.

data · object

The portfolio payload.

Show data fields

data.totalValue · number

The combined value of all holdings expressed in the requested currency.

data.currency · string

The currency code used for all value fields in this response (e.g. USD).

data.change24h · number

Percentage change in total portfolio value over the past 24 hours.

data.holdings · array

An ordered list of individual token positions.

Show holdings item fields

token · string

The token ticker symbol (e.g. SOL, ETH).

amount · string

The raw token balance held across all connected wallets, returned as a string to preserve precision.

valueUSD · number

The current USD value of this position.

pnlPercent · number

Profit-and-loss for this position expressed as a percentage. Negative values indicate a loss.

network · string

The blockchain network where this holding resides.

timestamp · string

ISO 8601 UTC timestamp indicating when the data was fetched.

---

GET /portfolio/history

Retrieve the historical total value of your portfolio over a given period. Use this endpoint to power charts, calculate returns over time, or feed your own analytics pipeline.

Required scope: read

Query Parameters

period · string · required

The lookback window for the history. Accepted values: 1d, 7d, 30d, 90d, 1y.

interval · string

The granularity of each data point. Accepted values: hourly, daily. Defaults to daily for periods longer than 7d and hourly for 1d.

Example Request

curl -X GET 'https://api.bigbrainape.com/v1/portfolio/history?period=7d&interval=daily' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Example Response

{
  "success": true,
  "data": {
    "period": "7d",
    "interval": "daily",
    "currency": "USD",
    "startValue": 10800.00,
    "endValue": 12450.50,
    "changePercent": 15.28,
    "dataPoints": [
      {
        "timestamp": "2024-01-09T00:00:00Z",
        "value": 10800.00
      },
      {
        "timestamp": "2024-01-10T00:00:00Z",
        "value": 11050.75
      },
      {
        "timestamp": "2024-01-11T00:00:00Z",
        "value": 10920.30
      },
      {
        "timestamp": "2024-01-12T00:00:00Z",
        "value": 11340.00
      },
      {
        "timestamp": "2024-01-13T00:00:00Z",
        "value": 11890.10
      },
      {
        "timestamp": "2024-01-14T00:00:00Z",
        "value": 12100.40
      },
      {
        "timestamp": "2024-01-15T00:00:00Z",
        "value": 12450.50
      }
    ]
  },
  "timestamp": "2024-01-15T14:32:00Z"
}

Response Fields

data.period · string

The requested lookback window.

data.interval · string

The granularity used for each data point in dataPoints.

data.currency · string

The currency used for all value fields.

data.startValue · number

Portfolio value at the start of the requested period.

data.endValue · number

Portfolio value at the end of the requested period (most recent snapshot).

data.changePercent · number

Percentage change between startValue and endValue.

data.dataPoints · array

Ordered list of value snapshots for the requested period and interval.

Show dataPoints item fields

timestamp · string

ISO 8601 UTC timestamp for this snapshot.

value · number

Total portfolio value at this point in time, in the requested currency.

Use interval=hourly with period=1d to get an intraday chart suitable for a 24-hour performance view on a dashboard.