Skip to content

Quickstart

This guide walks through making your first API call against Web3aggregator in under 10 minutes.

Prerequisites

  • An API key (request access via the website)
  • curl or any HTTP client

1. Authenticate

All requests authenticate via a bearer token in the Authorization header.

export W3A_API_KEY="your-api-key"

2. Make your first request

curl https://api.web3aggregator.io/v1/health \
  -H "Authorization: Bearer $W3A_API_KEY"

Expected response:

{
  "status": "ok",
  "region": "eu-helsinki",
  "version": "v1"
}

3. Query an RPC method

curl https://api.web3aggregator.io/v1/rpc/ethereum \
  -H "Authorization: Bearer $W3A_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_blockNumber",
    "params": [],
    "id": 1
  }'

Next steps