Skip to main content
Welcome to the Octav API documentation. Here you’ll find everything you need to integrate cryptocurrency portfolio tracking, transaction history, and analytics into your applications.

Quick Start

Get started with your first API call in minutes

Authentication

Learn how to authenticate your API requests

API Reference

Explore all available endpoints

Pricing

Understand our credit-based pricing model

​
What You Can Build

The Octav API enables you to:
  • Retrieve real-time portfolio balances across multiple chains
  • Track assets in wallets and DeFi protocols
  • Monitor net worth and PnL metrics
  • Include NFTs and protocol positions
  • Access complete transaction history
  • Filter by chain, protocol, transaction type
  • Search transactions with full-text search
  • Track fees and profit/loss per transaction
  • Get detailed token breakdowns by protocol
  • View token distribution across positions
  • Track token balances and valuations
  • Monitor historical token holdings
  • Retrieve historical portfolio snapshots
  • Subscribe to addresses for daily snapshots
  • Analyze portfolio performance over time
  • Track net worth changes

​
Key Features

Multi-Chain Support

Support for 20+ blockchain networks including Ethereum, Arbitrum, Base, Solana, and more

Real-Time Data

Fresh data with 1-minute caching and on-demand sync capabilities

DeFi Protocol Coverage

Track positions across hundreds of DeFi protocols automatically

Credit-Based Pricing

Pay only for what you use with our flexible credit system
https://mintcdn.com/octav-0131e508/anHQal-NxcOY-dXz/logo/SOC2_Logo_Revised_1_.591b2acad61e2.png?fit=max&auto=format&n=anHQal-NxcOY-dXz&q=85&s=42d93e509c50fd269247cb4f2bb1ba55

SOC 2 Compliant

Enterprise-grade security and compliance standards

Production Ready

Rate limiting, error handling, and status monitoring built-in

​
API Overview

​
Base URL

https://api.octav.fi

​
Authentication

All API requests require an API key passed in the Authorization header: 
Authorization: Bearer YOUR_API_KEY
Get Your API Key — Create and manage API keys at data.octav.fi

​
Rate Limits

Rate Limit

360 requests / minute / API keyHigher limits available upon request

​
Response Format

All endpoints return JSON responses with consistent structure: 
{
  "data": { ... },
  "status": "success"
}

​
Core Endpoints

Portfolio

GET /v1/portfolioRetrieve portfolio holdings with asset breakdown by protocol and chainCost: 1 credit per call

Virtual Users

GET /v1/virtual-users · /v1/virtual-users/portfolioList virtual users and retrieve their portfolio holdings (Pro)Cost: 1 credit per call / per address

Nav

GET /v1/navRetrieve Net Asset Value of an addressCost: 1 credit per call

Transactions

GET /v1/transactionsGet paginated transaction history with filtering and searchCost: 1 credit per call

Token Overview

GET /v1/token-overviewDetailed token breakdown across wallet and protocol positionsCost: 1 credit per call

Historical Portfolio

GET /v1/historicalRetrieve historical portfolio snapshots for any dateCost: 1 credit per call

Sync Transactions

POST /v1/sync-transactionsTrigger transaction synchronization for an addressCost: 1 credit + 1 per 250 txns

Status

GET /v1/statusCheck sync status and data freshnessCost: Free (0 credits)

Credits

GET /v1/creditsCheck your remaining credit balanceCost: Free (0 credits)

​
Next Steps

Get Your API Key

Visit data.octav.fi to create your API key

Make Your First Request

Follow our Quickstart Guide to make your first API call

Explore Endpoints

Browse the API Reference to see all available endpoints

Monitor Usage

Track your credit usage and manage your account at the Dev Portal

​
Need Help?

Join Discord

Get help from the team and community

Contact Us

Reach out for enterprise support