AR.IO LogoAR.IO Documentation
TurboPayment Service

Balance

Account balance and credit management

Get Current Balance of winc

Use a signed request or a previously obtained JWT to get the signing wallet's current service balance in winc

GET
/balance

Query Parameters

address?string

Destination wallet address, required if no signature headers are provided

Header Parameters

x-signature?string

The signature value derived from signing the request's data concatenated with the provided nonce using the private key from the provided public key

x-nonce?string

The nonce value concatenated with the request's data when deriving the provided the signature

x-public-key?string

The "modulus" of the JWK used to create the signature header

Response Body

curl -X GET "https://loading/v1/balance?address=string" \  -H "x-signature: string" \  -H "x-nonce: string" \  -H "x-public-key: string"
{
  "controlledWinc": "string",
  "winc": "string",
  "effectiveBalance": "string",
  "givenApprovals": [
    {
      "approvalDataItemId": "abcdefghijklmnopqrxtuvwxyz123456789ABCDEFGH",
      "approvedAddress": "abcdefghijklmnopqrxtuvwxyz123456789ABCDEFGH",
      "payingAddress": "abcdefghijklmnopqrxtuvwxyz123456789ABCDEFGH",
      "approvedWincAmount": "332824926",
      "usedWincAmount": "332824926",
      "creationDate": "2023-05-17T21:46:38.404Z",
      "expirationDate": "2023-05-17T21:46:38.404Z"
    }
  ],
  "receivedApprovals": [
    {
      "approvalDataItemId": "abcdefghijklmnopqrxtuvwxyz123456789ABCDEFGH",
      "approvedAddress": "abcdefghijklmnopqrxtuvwxyz123456789ABCDEFGH",
      "payingAddress": "abcdefghijklmnopqrxtuvwxyz123456789ABCDEFGH",
      "approvedWincAmount": "332824926",
      "usedWincAmount": "332824926",
      "creationDate": "2023-05-17T21:46:38.404Z",
      "expirationDate": "2023-05-17T21:46:38.404Z"
    }
  ]
}
"Invalid signature or missing required headers"
"User Not Found"
"Cloud Database Unavailable"

How is this guide?