Historical Portfolio

Retrieve portfolio snapshots from specific dates

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

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

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;
}

Compare Dates

const [portfolio1, portfolio2] = await Promise.all([
  fetch(`https://api.octav.fi/v1/historical?addresses=${address}&date=2024-10-01`,
    { headers: { 'Authorization': `Bearer ${apiKey}` } }).then(r => r.json()),
  fetch(`https://api.octav.fi/v1/historical?addresses=${address}&date=2024-11-01`,
    { headers: { 'Authorization': `Bearer ${apiKey}` } }).then(r => r.json())
]);

const change = parseFloat(portfolio2.networth) - parseFloat(portfolio1.networth);
console.log(`30-day change: $${change.toFixed(2)}`);

---

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

---

Related Endpoints

Portfolio

Current portfolio state

Token Overview

Historical token breakdown