Skip to main content
Access historical portfolio data for subscribed addresses, enabling time-based analysis and portfolio performance tracking.
Subscription Required — You must subscribe to an address before retrieving historical data. Contact support or use the dashboard.
Cost: 1 credit per call
Interactive Playground: Test this endpoint in the API Playground. Get your API key at data.octav.fi

​
Endpoint

GET https://api.octav.fi/v1/historical

​
Parameters

​
addresses
string
required
EVM or SOL wallet address
​
date
string
required
Date in YYYY-MM-DD format (e.g., 2024-11-01)

​
Example

curl "https://api.octav.fi/v1/historical?addresses=0x6426af...&date=2024-11-01" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

​
Returns the same structure as the Portfolio endpoint, but with data as it existed on the specified date.

​
Use Cases

  • Performance Tracking
  • Compare Dates
async function trackPerformance(address, days) {
  const snapshots = [];
  for (let i = 0; i < days; i++) {
    const date = new Date();
    date.setDate(date.getDate() - i);
    const dateStr = date.toISOString().split('T')[0];

    const response = await fetch(
      `https://api.octav.fi/v1/historical?addresses=${address}&date=${dateStr}`,
      { headers: { 'Authorization': `Bearer ${apiKey}` } }
    );
    snapshots.push(await response.json());
  }
  return snapshots;
}

​
Subscription

To enable historical tracking:
  1. Login to data.octav.fi
  2. Navigate to Historical Tracking
  3. Add addresses for daily snapshots Or contact support via Discord

Portfolio

Current portfolio state

Token Overview

Historical token breakdown