Historical Portfolio

Access historical portfolio data for a subscribed address, 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"

const response = await fetch(
  `https://api.octav.fi/v1/historical?addresses=${address}&date=2024-11-01`,
  { headers: { 'Authorization': `Bearer ${apiKey}` } }
);
const portfolio = await response.json();
console.log(`Net worth: $${portfolio.networth}`);

response = requests.get(
    'https://api.octav.fi/v1/historical',
    params={'addresses': address, 'date': '2024-11-01'},
    headers={'Authorization': f'Bearer {api_key}'}
)
portfolio = response.json()
print(f"Net worth: ${portfolio['networth']}")

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

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:

Login to data.octav.fi
Navigate to Historical Tracking
Add addresses for daily snapshots Or contact support via Discord

Portfolio

Current portfolio state

Token Overview

Historical token breakdown

Getting Started

Endpoints

Playground

AI Development

Migrate to Octav

Reference

Endpoint

Parameters

Example

Response

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

Use Cases

Subscription

Portfolio

Token Overview

​Endpoint

​Parameters

​Example

​Response

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

​Use Cases

​Subscription

​Related Endpoints

Portfolio

Token Overview

Endpoint

Parameters

Example

Response

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

Use Cases

Subscription

Related Endpoints