ar.io DocumentationPricing
Pricing and cost calculation endpoints
Get Amount of Credits in winc for Byte Count
Returns the current amount of winc it will cost to upload a given byte count worth of data items
Path Parameters
A positive integer representing a byte count of data items
^[0-9]+$Response Body
curl -X GET "https://turbo.ardrive.io/v1/price/bytes/5242880"{
"winc": "332824926",
"adjustments": [
{
"name": "Adjustment",
"description": "Some great subsidy",
"operatorMagnitude": "0.6",
"operator": "multiply",
"adjustmentAmount": "-12300",
"promoCode": "SOME-GREAT-CODE"
}
]
}"Invalid byte count""Pricing Oracle Unavailable"Get winc for Payment Type and Amount
Returns the current amount of winc this service will quote for a given payment type and amount
Path Parameters
Type for a given price request. Either "fiat" type or "token" type
Payment amount in a given currency's smallest unit value. For example, $10 USD is 1000. 1 AR is 1000000000000
Query Parameters
Comma-separated list of promo codes
Destination wallet address. This will override the signature header's public key if provided
Header Parameters
The signature value derived from signing the request's data concatenated with the provided nonce using the private key from the provided public key
The nonce value concatenated with the request's data when deriving the provided the signature
The "modulus" of the JWK used to create the signature header
Response Body
curl -X GET "https://turbo.ardrive.io/v1/price/kyve/1000?promoCode=string&destinationAddress=string" \ -H "x-signature: string" \ -H "x-nonce: string" \ -H "x-public-key: string"{
"winc": "332824926",
"adjustments": [
{
"name": "Adjustment",
"description": "Some great subsidy",
"operatorMagnitude": "0.6",
"operator": "multiply",
"adjustmentAmount": "-12300",
"promoCode": "SOME-GREAT-CODE"
}
],
"fees": [
{
"name": "Adjustment",
"description": "Some great subsidy",
"operatorMagnitude": "0.6",
"operator": "multiply",
"adjustmentAmount": "-12300",
"promoCode": "SOME-GREAT-CODE"
}
],
"actualPaymentAmount": 800,
"quotedPaymentAmount": 1000
}"Payment Amount is Invalid""Fiat Oracle Unavailable"Arweave-compatible price endpoint (legacy)
Legacy endpoint for ArConnect and ecosystem tool compatibility.
Returns the raw Winston credit amount as a plain string (not JSON). This matches the format expected by ArConnect and other Arweave ecosystem tools.
Differences from /v1/price/bytes/{byteCount}:
- Returns plain string instead of JSON
- No adjustments metadata
- Kept for backward compatibility with existing tools
Path Parameters
Currently unused, kept for compatibility
Number of bytes
^[0-9]+$Header Parameters
The signature value derived from signing the request's data concatenated with the provided nonce using the private key from the provided public key
The nonce value concatenated with the request's data when deriving the provided the signature
The "modulus" of the JWK used to create the signature header
Response Body
curl -X GET "https://turbo.ardrive.io/v1/price/arweave/5242880" \ -H "x-signature: string" \ -H "x-nonce: string" \ -H "x-public-key: string""1000000""Invalid byte count""Pricing Oracle Unavailable"How is this guide?