Skip to main content
Octav uses a flexible credit-based system that allows you to pay only for what you use. Credits never expire, giving you complete control over your API costs.
Purchase Credits - Buy credit packages at data.octav.fi

Credit Packages

Choose the package that fits your needs. All credits never expire.

Starter

4,000 Credits$100.00$0.025 per creditPerfect for small projects and testing

Small Team

100,000 Credits$2,500.00$0.025 per creditIdeal for growing applications

Intensive Usage

1,000,000 Credits$20,000.00$0.020 per creditBest value for high-volume usage
Volume Discount - Save 20% with the Intensive Usage package (0.020vs0.020 vs 0.025 per credit)

Credit Costs

API Endpoints

These endpoints are completely free to call:
EndpointMethodCost
/v1/creditsGET0 credits
/v1/statusGET0 credits
Perfect for testing authentication and monitoring sync status.
Most API calls cost 1 credit:
EndpointMethodCost
/v1/portfolioGET1 credit
/v1/transactionsGET1 credit
/v1/token-overviewGET1 credit P
/v1/historicalGET1 credit
/v1/sync-transactionsPOST1 credit
P Requires Octav PRO subscription
When syncing transactions, indexing costs apply:1 credit per 250 transactions indexed
  • First-time indexing of an address incurs indexing costs
  • Once indexed, transactions are stored permanently
  • Future queries don’t re-index (no additional cost)
  • Only new transactions since last sync require indexing
One-Time Cost: Indexing happens once. After initial sync, you only pay the 1 credit API call fee.

Cost Examples

Example 1: Portfolio Tracking

Tracking 5 wallets, checking portfolios once per hour:

API Calls

5 addresses x 24 hours x 30 days = 3,600 API calls

Credit Cost

3,600 calls x 1 credit = 3,600 credits

Monthly Cost

3,600 credits x 0.025=0.025 = **90/month**

Example 2: Transaction History

Initial sync for an address with 10,000 transactions:

API Call

1 sync-transactions call = 1 credit

Indexing Cost

10,000 transactions / 250 = 40 batches x 1 credit = 40 credits

Total First Sync

1 + 40 = 41 credits ($1.03)

Future Updates

Only 1 credit per call for new transactions

Example 3: High-Volume Application

Application making 100,000 API calls per month:
  • Starter Package
  • Small Team Package
  • Intensive Usage
Not recommended - Would need 25 packages100,000 credits x 0.025=0.025 = **2,500**

How Credits Work

Credit System Benefits

No Expiration

Credits never expire - buy when convenient, use when needed

Predictable Costs

Know exactly how much each API call costs

No Subscriptions

No monthly fees or commitments - pay as you grow

Volume Discounts

Save money with larger credit packages

Permanent Indexing Advantage

When you sync an address for the first time:
  1. Pay indexing cost - 1 credit per 250 transactions
  2. Transactions stored permanently - Data saved in Octav’s system
  3. Future queries are cheap - Only 1 credit per API call
  4. No re-indexing costs - Historical data already available
Example:
  • First sync: 10,000 transactions = 41 credits ($1.03)
  • Future calls: 1 credit each ($0.025)
  • Query 100 times: 100 credits ($2.50)
  • Total: 141 credits vs re-indexing 4,100 credits each time
This makes regular monitoring very cost-effective!

Monitoring Usage

Check Your Credits

Use the free /v1/credits endpoint anytime:
curl -X GET https://api.octav.fi/v1/credits \
  -H "Authorization: Bearer YOUR_API_KEY"

Developer Portal

Track detailed usage at data.octav.fi:
  • Credit balance and history
  • API call volumes
  • Usage by endpoint
  • Historical usage patterns
  • Purchase more credits

Cost Optimization Tips

Leverage the free /v1/status and /v1/credits endpoints:
  • Check sync status before calling expensive endpoints
  • Monitor credit balance without cost
  • Verify authentication without using credits
Portfolio data is cached for 1 minute:
  • Multiple calls within 1 minute return cached data
  • No need to implement your own caching for under 1 minute intervals
  • Use waitForSync=false (default) unless you need the absolute latest data
Request multiple addresses in a single call:
# Instead of 3 separate calls (3 credits):
curl "https://api.octav.fi/v1/portfolio?addresses=0x123"
curl "https://api.octav.fi/v1/portfolio?addresses=0x456"
curl "https://api.octav.fi/v1/portfolio?addresses=0x789"

# Use one call (1 credit):
curl "https://api.octav.fi/v1/portfolio?addresses=0x123,0x456,0x789"
Use filters to reduce unnecessary data:
  • Filter by networks to query specific chains
  • Use txTypes to get only relevant transaction types
  • Apply startDate and endDate for time-based queries
  • Set appropriate limit values for pagination
For addresses with 100,000+ transactions:
  • Contact support for assistance
  • Consider filtering by specific chains
  • Use date ranges to limit initial sync
  • Addresses over 100k transactions are not auto-indexed

Enterprise Solutions

Need more than standard packages?

Custom Pricing

Volume discounts for 10M+ creditsContact us for enterprise pricing

Dedicated Support

Priority support and SLAsTechnical account management

Higher Rate Limits

Custom rate limits beyond 360/minDedicated infrastructure options

Custom Solutions

White-label optionsCustom integrations and features

Frequently Asked Questions

No, credits never expire. Purchase credits whenever convenient and use them at your own pace.
Credits are non-refundable, but since they never expire, you can always use them in the future.
API calls will fail with an insufficient credits error. Purchase more credits at data.octav.fi to continue.
Yes, all API keys under your account share the same credit pool.
If you sync 125 transactions, you’re charged for a full 250-transaction batch (1 credit). Batches are rounded up.
We don’t offer a free tier, but the Starter package ($100) provides 4,000 credits for testing and small projects. The /v1/credits and /v1/status endpoints are always free.

Get Started

Create Account

Sign up at data.octav.fi

Purchase Credits

Choose a credit package that fits your needs

Generate API Key

Create an API key in the developer portal

Start Building

Make your first API call using the Quickstart Guide

Need Help?