ar.io DocumentationTurbo APIs
Turbo provides high-performance upload and payment services for the Arweave network, offering fast, reliable data uploads with instant confirmation and transparent pricing.
Base URL
Both services are served together from https://turbo.ardrive.io, a single consolidated host that amalgamates the upload service (upload.ardrive.io) and the payment service (payment.ardrive.io).
The two are mounted at different prefixes, which is why the examples on the reference pages differ:
| Service | Base URL | Example |
|---|---|---|
| Upload | https://turbo.ardrive.io | GET /price/:token/:byteCount |
| Payment | https://turbo.ardrive.io/v1 | GET /v1/price/bytes/:byteCount |
Upload endpoints are served at the root, not under /v1 — prefixing them
returns a 404. Payment endpoints require the /v1 prefix.
Services
Upload Service
Fast, reliable data uploads to Arweave with instant confirmation and metadata management
Payment Service
Transparent pricing, payment processing, and credit management for Turbo uploads
Upload Service
The Turbo Upload Service provides high-performance data uploads to the Arweave network with features including:
- Fast Uploads - Optimized upload processing for quick data submission
- Instant Confirmation - Immediate upload confirmations and transaction IDs
- Metadata Management - Comprehensive data tagging and organization
- Account Management - User account and upload history tracking
- Service Information - Real-time service status and capabilities
Key endpoints include account management, upload processing, pricing information, and transaction data retrieval.
Payment Service
The Turbo Payment Service handles all financial aspects of data uploads with transparent and flexible payment options:
- Transparent Pricing - Clear, upfront costs for all upload operations
- Multiple Currencies - Support for various payment methods and currencies
- Credit Management - Prepaid credits and balance tracking
- Payment Processing - Secure payment handling and transaction management
- Approval Workflows - Payment authorization and confirmation flows
Key endpoints include balance management, payment processing, pricing calculations, and credit redemption.
Getting Started with Turbo
- Choose your service - Upload for data submission, Payment for financial operations
- Review the APIs documentation - Detailed endpoint specifications and examples
- Test with sample data - Try uploads and payment flows with test data
- Integrate into your application - Implement the APIs in your workflow
Use the Turbo SDK
For a more convenient integration experience, consider using the Turbo SDK instead of direct API calls:
Interact with Turbo via the SDK
Use the Turbo SDK for simplified integration with built-in error handling, retries, and TypeScript support
The SDK provides a higher-level interface with built-in error handling, automatic retries, and full TypeScript support, making it easier to integrate Turbo services into your applications.
How is this guide?