Grid402 Grid402
x402 Global Autonomous Agent Hub • 22 Services

Global Data and M2M Utility Infrastructure for AI Agents

Grid402 empowers autonomous AI agents (Claude, Cursor, LangChain, CrewAI, and Coinbase AgentKit) to query 22 global and Brazilian public-domain endpoints via HTTP 402 or a Prepaid Session Pass (<15ms), settling USDC micropayments on Base with ECDSA cryptographic proof.

No-Wallet Onboarding — 3 minutes

You can test right now with X-Payment: demo (5 queries per hour per IP). For production without managing transactions, install the SDK/MCP and configure the facilitator or a Session Pass; your agent simply calls the URL.

curl -H "X-Payment: demo" https://grid402.online/api/v1/cnpj?cnpj=00000000000191
View prices, limits and examples →  ·  Buy Session Pass →

Zero Human Sign-up

No static API keys, credit cards, or logins required. AI agents hire services directly via on-chain Web3 wallets (MetaMask, Rabby, Coinbase Wallet, and others).

Cryptographic Oracle

Every response includes a deterministic ECDSA secp256k1 digital signature (_oracle_proof key), statelessly verifiable in under 1 ms.

x402 Session Pass (<15ms)

Purchase 400 to 6,000 credits in a single Base USDC transaction and execute high-frequency M2M calls in under 15ms without waiting for blocks.

1. Model Context Protocol (MCP) Integration

Add all 22 global and Brazilian tools to Claude Desktop or Cursor with 1 click.

{
  "mcpServers": {
    "grid402": {
      "command": "npx",
      "args": ["-y", "grid402-mcp@latest"],
      "env": {
        "GRID402_BASE_URL": "https://grid402.online"
      }
    }
  }
}

2. Official ElizaOS Plugin (grid402-plugin-elizaos)

Allow autonomous AI agents on ElizaOS to query FX rates, spot crypto, global markets, and OFAC/AML sanctions.

import { grid402Plugin } from "grid402-plugin-elizaos";

export const defaultCharacter = {
  name: "GridMarketAgent",
  plugins: [grid402Plugin],
  settings: {
    secrets: {
      // Top up your balance at https://grid402.online/#topup
      GRID402_PASS_TOKEN: "pass_g402_live..."
    }
  }
};

3. Python Code for Autonomous Agents

Direct consumption handling the HTTP 402 challenge or using a Session Pass (`pass_g402_...`).

import requests

BASE_URL = "https://grid402.online"

def query_oracle(endpoint, payment_proof=None):
    headers = {"Accept": "application/json"}
    if payment_proof:
        # Accepts Base TxHash (0x...), Session Pass (pass_g402_...), or "demo"
        headers["X-Payment"] = payment_proof
        
    res = requests.get(f"{BASE_URL}{endpoint}", headers=headers)
    
    if res.status_code == 402:
        body = res.json()
        print(f"[402 Challenge] Price: {body.get('price_usdc')} USDC on Base")
        print(f"[Free Preview]  {body.get('preview')}")
        return body
        
    data = res.json()
    print("[200 OK] Oracle Proof Verified:", "_oracle_proof" in data)
    return data

# Example: Global Corporate Identity (GLEIF LEI) or OFAC AML
query_oracle("/api/v1/lei?lei=5493006MHB84DD0ZWV18", payment_proof="demo")

4. Quick Terminal Test (cURL)

Inspect x402 challenges, issue a Session Pass, or validate cryptographic proofs directly in the terminal.

# 1. Inspect HTTP 402 Challenge + Free Teaser Preview
curl -i "https://grid402.online/api/v1/lei?lei=5493006MHB84DD0ZWV18"

# 2. Issue a Prepaid Session Pass (400 credits = 2.0000 USDC or "demo" in Sandbox)
curl -H "X-Payment: demo" "https://grid402.online/api/v1/pass"

# 3. Execute <15ms calls using your Session Pass or Base TxHash
curl -H "X-Payment: pass_g402_YOUR_TOKEN" \
  "https://grid402.online/api/v1/global-markets?market=US&base=USD"

# 4. Stateless ECDSA Oracle Proof verification (Free, <1ms)
curl -X POST "https://grid402.online/api/v1/verify" \
  -H "Content-Type: application/json" \
  -d '{"full_response_with_proof": {...}}'

Catalog of All 22 Global Endpoints and Fees

Per-call pricing in USDC on Base Mainnet or in Session Pass credits.

Endpoint Service / Public Source Fee (USDC / Pass) ECDSA Proof
/api/v1/pass Prepaid Session Pass (400 to 6,000 credits; 1 credit = 0.0050 USDC) for ultra-fast M2M calls (<15ms) 2 / 5 / 20 USDC (400 / 1,000 / 6,000 cr) ✓ Yes
/api/v1/domain-audit Composite 1-call bundle: authoritative DNS resolution + port 443 SSL/TLS certificate audit + BGP/ASN routing intelligence with consolidated risk score (0-100). 0.0150 USDC (3 cr) ✓ Yes
/api/v1/kyb-audit Composite 1-call bundle: GLEIF Global LEI + OFAC/UN Sanctions and Web3 AML + Brazilian Compliance 360 with unified automated onboarding verdict. 0.0300 USDC (6 cr) ✓ Yes
/api/v1/market-snapshot Composite 1-call bundle: Global Exchanges and ECB FX + Official PTAX and BACEN Indicators + Spot Crypto Prices for autonomous treasury agents. 0.0100 USDC (2 cr) ✓ Yes
/api/v1/lei Global Corporate Identity in 200+ countries via GLEIF LEI (ISO 17442, CC0) 0.0200 USDC (4 cr) ✓ Yes
/api/v1/ofac International Sanctions (OFAC SDN / UN) + Web3 AML Inspector on Base 0.0200 USDC (4 cr) ✓ Yes
/api/v1/notarize UTC Timestamp and M2M Cryptographic Notarization (SHA-256 + ECDSA) 0.0050 USDC (1 cr) ✓ Yes
/api/v1/global-markets Global Exchange Calendar (US, EU, UK, BR) + 30+ ECB Currencies 0.0050 USDC (1 cr) ✓ Yes
/api/v1/forex Official PTAX FX Rates (USD, EUR, GBP to BRL) with explicit timestamps 0.0050 USDC (1 cr) ✓ Yes
/api/v1/crypto Spot prices (BTC, ETH, SOL, USDC, BASE) in USD and BRL 0.0050 USDC (1 cr) ✓ Yes
/api/v1/dns Authoritative DNS zone resolution (A, AAAA, MX, TXT, NS, CNAME) 0.0050 USDC (1 cr) ✓ Yes
/api/v1/ssl Port 443 TLS certificate and X.509 chain audit 0.0050 USDC (1 cr) ✓ Yes
/api/v1/asn BGP routing, ASN number, CIDR block, and IP country lookup 0.0050 USDC (1 cr) ✓ Yes
/api/v1/cep Brazilian postal address and official IBGE municipality code 0.0050 USDC (1 cr) ✓ Yes
/api/v1/cnpj Official Brazilian corporate tax registry (Receita Federal) 0.0200 USDC (4 cr) ✓ Yes
/api/v1/indicators Selic, CDI, and IPCA inflation indices (Central Bank and IBGE) 0.0050 USDC (1 cr) ✓ Yes
/api/v1/holidays Official ANBIMA and Febraban banking holiday calendar 0.0050 USDC (1 cr) ✓ Yes
/api/v1/workdays ANBIMA banking business days calculator and D+N projection 0.0050 USDC (1 cr) ✓ Yes
/api/v1/sanctions Administrative sanctions and debarment registries (CGU CEIS/CNEP) 0.0100 USDC (2 cr) ✓ Yes
/api/v1/simples Simples Nacional and MEI tax regime status 0.0100 USDC (2 cr) ✓ Yes
/api/v1/compliance Consolidated Compliance 360 corporate risk score (0 to 100) 0.0300 USDC (6 cr) ✓ Yes
/api/v1/verify Stateless mathematical-cryptographic oracle verification (<1ms) Free Native
/status Free Summary (/status) Free -

Manifests for Automated Discovery

Open standards for LLMs and autonomous agents to map Grid402.