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.
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=00000000000191No static API keys, credit cards, or logins required. AI agents hire services directly via on-chain Web3 wallets (MetaMask, Rabby, Coinbase Wallet, and others).
Every response includes a deterministic ECDSA secp256k1 digital signature (_oracle_proof key), statelessly verifiable in under 1 ms.
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.
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"
}
}
}
}
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..."
}
}
};
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")
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": {...}}'
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 | - |
Open standards for LLMs and autonomous agents to map Grid402.