Payments

AstraNode uses HTTP 402 Payment Required to enable pay-per-call RPC.

🔄 Flow Overview

1

Use free calls

You use free calls (up to 50/day).

2

402 returned

After that, the server returns 402 Payment Required.

3

Response includes payment schema

The response includes a JSON schema with payment info.

4

Pay the shown amount

You pay the shown USDC amount to the payTo wallet.

5

Add payment header

Add the header to continue RPC access:

X-PAYMENT: pay-demo-astranode
6

Continue using RPC

RPC access continues normally.

🧩 402 JSON Schema

{
  "x402Version": 1,
  "accepts": [
    {
      "scheme": "exact",
      "network": "base:8453",
      "maxAmountRequired": "1000",
      "payTo": "0xAstraTreasuryWallet",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "description": "Free quota exhausted. Please pay to continue."
    }
  ]
}

🪙 Supported Asset

Asset
Chain
Contract

USDC

Base

0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

PreviousUsageNextFAQ