Cost: 1 credit + 1 credit per 250 transactions indexed
Interactive Playground: Test this endpoint in the API Playground. Get your API key at data.octav.fi
Endpoint
Request Body
Example
Response
Returns a string indicating sync status:"Address is syncing"- Synchronization started"Address already syncing"- Address is currently syncing
Cost Breakdown
API Call Cost
API Call Cost
1 credit per sync request
Indexing Cost
Indexing Cost
1 credit per 250 transactions indexed
- You pay 1 credit each time the address’s indexed transaction count passes another multiple of 250 (250, 500, 750, …)
- Transactions are indexed permanently and are never charged twice
- Only new transactions count toward the next multiple of 250, so an active wallet keeps incurring indexing credits as it grows
Example Costs
- First Sync
- Update Sync
- No New Transactions
Address with 10,000 transactions:
- API call: 1 credit
- Indexing: 40 credits (10,000 ÷ 250)
- Total: 41 credits ($1.03)
Use Cases
- Force Update
- Check Before Sync
Force immediate transaction sync:
Best Practices
Check Status First
Check Status First
Use the Status endpoint to check if a sync is needed before triggering oneAvoid unnecessary sync costs by checking
transactionsLastSync timestampHandle Concurrent Syncs
Handle Concurrent Syncs
If you receive “Address already syncing”, wait for the current sync to completeTypical sync time: 5-30 seconds depending on transaction count
Monitor Costs
Monitor Costs
First-time syncs can be expensive for addresses with many transactionsRegular syncs are cheap as only new transactions are indexed
Related Endpoints
Status
Check when last synced
Transactions
Query synced transactions