# StakePad Ethereum Data API

StakePad exposes Ethereum consensus, validator, execution, rewards, and network data through POST endpoints.

## Agent payment

This API uses x402 V2 for pay-per-call access when no valid GlobalStake Bearer token is supplied. Send a request without payment to receive HTTP 402 and a Base64URL `PAYMENT-REQUIRED` header. Retry the identical request with a Base64 or Base64URL `PAYMENT-SIGNATURE` header.

Network: eip155:8453. Asset: USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913). Payee: 0xFF70e5D3649A5F88f2230e7A6433711B00980f78. Payment scheme: exact. Maximum payment validity: 300 seconds.

## API

Canonical API base URL: https://stakepad-api.globalstake.io/ethereum/globalstake/ethereum-data/v1/
Agent OpenAPI schema: https://stakepad-api.globalstake.io/ethereum/x402/api-doc/openapi.json
Agent Swagger UI: https://stakepad-api.globalstake.io/ethereum/x402-swagger/
Discovery manifest: https://stakepad-api.globalstake.io/ethereum/.well-known/x402
MCP endpoint: https://stakepad-api.globalstake.io/ethereum/x402/mcp
Health endpoint: POST /globalstake/ethereum-data/v1/health (free).
All other endpoints use deterministic route pricing below and in the discovery manifest. Prices are integer USDC atomic units (1,000,000 = 1 USDC).

## Price rules

- `/globalstake/ethereum-data/v1/health` (exact) — free
- `/chart` (suffix) — 50000 microusd
- `/graffiti_wall` (suffix) — 50000 microusd
- `balance_history` (contains) — 30000 microusd
- `income_detail_history` (contains) — 30000 microusd
- `/validators` (suffix) — 30000 microusd
- `/validators_post` (suffix) — 30000 microusd
- `/slot/` (contains) — 20000 microusd
- `/rewards/` (contains) — 20000 microusd
- `/gas_now` (suffix) — 3000 microusd
- `/execution/` (contains) — 20000 microusd
- `/availability` (suffix) — 3000 microusd
- `/latest_state` (suffix) — 3000 microusd
- `/ens` (suffix) — 3000 microusd
- All other https://stakepad-api.globalstake.io/ethereum/globalstake/ethereum-data/v1/ endpoints — 10000 microusd