# Grid402 > Hub de microservicos e dados abertos para agentes autonomos de IA e aplicacoes M2M sob o protocolo HTTP 402 com liquidacao em USDC na rede Base. ## Core Documentation - [Full LLM Context](https://grid402.online/llms-full.txt): Documentacao exaustiva com schemas JSON e contratos de endpoints para modelos de linguagem - [Catálogo Completo de Serviços](https://grid402.online/catalog): Preço, limites, exemplos e status de todos os endpoints - [Trust Center](https://grid402.online/trust): SLA, disponibilidade histórica, metodologia e política de incidentes - [Agent Hub](https://grid402.online/agent-hub): Documentação e exemplos de integração para agentes autônomos - [Growth Program](https://grid402.online/growth): Starter, Builders, Referrals para agentes autônomos - [Builder Reputation](https://grid402.online/reputation): Reputação Pública de builders Grid402 - [Payment Dashboard](https://grid402.online/payment-dashboard): Pay-per-Request vs Session Pass — visão de uma única tela - [Central de Agentes de IA](https://grid402.online/agents): Guia rapido de integracao para agentes autonomos, Claude Desktop, Python e cURL - [OpenAPI Specification](https://grid402.online/openapi.json): Especificacao completa e interativa da API no padrao OpenAPI 3.1 - [MCP Server Card](https://grid402.online/.well-known/mcp/server-card.json): Ficha de descoberta de capacidades SEP-1649 para servidores MCP - [MCP Well-Known Manifest](https://grid402.online/.well-known/mcp.json): Manifesto estruturado com a lista de ferramentas MCP do Grid402 - [AI Plugin Manifest](https://grid402.online/.well-known/ai-plugin.json): Manifesto padrao para plugins e descoberta por motores de IA - [Oracle Verifier API](https://grid402.online/api/v1/verify): Endpoint sem estado para validacao criptografica de provas de oraculo em menos de 1 ms - [Status e Saude do Hub](https://grid402.online/status): Verificacao de disponibilidade e resumo operacional dos servicos - [Sobre a Organizacao](https://grid402.online/about): Missao, arquitetura Zero-DB e endereco institucional - [Canais de Contato](https://grid402.online/contact): Suporte tecnico, encarregado de dados DPO e telefonia - [Termos de Servico](https://grid402.online/terms): Condicoes de uso, direitos autorais reservados (Lei 9.609/98 e 9.610/98) e termos M2M - [Politica de Privacidade](https://grid402.online/privacy): Diretrizes de privacidade, conformidade LGPD e retencao de logs ## Public Micro-Services APIs - [Forex Rates API](https://grid402.online/api/v1/forex): Cotacoes cambiais oficiais de USD, EUR e GBP para BRL em tempo real - [Crypto Tickers API](https://grid402.online/api/v1/crypto): Precos de mercado spot de BTC, ETH, SOL, USDC e BASE - [DNS Records Lookup](https://grid402.online/api/v1/dns?domain=base.org): Resolucao autoritativa de registros A, AAAA, MX, TXT, NS e CNAME - [TLS and SSL Inspector](https://grid402.online/api/v1/ssl?host=base.org): Inspecao e auditoria de certificados TLS e SSL na porta 443 - [ASN and BGP Intelligence](https://grid402.online/api/v1/asn?ip=1.1.1.1): Roteamento BGP, bloco alocado e numero ASN de IPs - [Domain Audit (DNS + SSL + ASN)](https://grid402.online/api/v1/domain-audit?host=base.org): Auditoria consolidada de dominio com DNS, TLS e IP/BGP numa unica chamada - [KYB e Compliance Audit (CNPJ + OFAC + LEI)](https://grid402.online/api/v1/kyb-audit?cnpj=00000000000191): Triagem consolidada KYB/AML numa unica chamada - [Market Snapshot (Forex + Crypto + Indicadores)](https://grid402.online/api/v1/market-snapshot): Snapshot consolidado de mercado numa unica chamada - [CEP Postal Address API](https://grid402.online/api/v1/cep?code=01310100): Resolucao de endereco postal brasileiro e codigo municipal IBGE - [CNPJ Corporate Registry API](https://grid402.online/api/v1/cnpj?cnpj=00000000000191): Dados cadastrais de Pessoa Juridica na Receita Federal - [Economic Indicators API](https://grid402.online/api/v1/indicators): Taxas oficiais Selic (meta e diaria), CDI anual e diario, IPCA 12m e mensal (BCB e IBGE) - [National and Banking Holidays API](https://grid402.online/api/v1/holidays?year=2026): Calendario oficial de feriados nacionais e bancarios (ANBIMA e Febraban) com calculo matematico Meeus - [ANBIMA Workdays Calculator API](https://grid402.online/api/v1/workdays): Calculadora de dias uteis bancarios ANBIMA com contagem de intervalo e projecao de prazos - [Administrative Sanctions API](https://grid402.online/api/v1/sanctions?cnpj=00000000000191): Sancoes administrativas ativas nos cadastros CEIS e CNEP (CGU) - [Simples Nacional Tax Status API](https://grid402.online/api/v1/simples?cnpj=00000000000191): Enquadramento tributario no Simples Nacional e MEI (SIMEI) - [Compliance Score 360 API](https://grid402.online/api/v1/compliance?cnpj=00000000000191): Dossie consolidado de compliance e score de risco cadastral (0 a 100) - [Global LEI Corporate Registry API](https://grid402.online/api/v1/lei?lei=5493006MHB84DD0ZWV18): Identidade corporativa global ISO 17442 em 200+ jurisdicoes via GLEIF (Licenca CC0 1.0 Dominio Publico) - [Global Sanctions (OFAC/UN) e Web3 AML API](https://grid402.online/api/v1/ofac?target=0x8589427373d6d84e98730d7795d8f6f8731fda16): Screening global em listas OFAC SDN (US Treasury) e ONU + inspecao AML on-chain de carteiras EVM na Base Mainnet - [M2M Cryptographic Timestamp e Notarization API](https://grid402.online/api/v1/notarize?content=Grid402-M2M-Contract-v1): Certificado criptografico de existencia e carimbo do tempo UTC assinado com ECDSA secp256k1 para contratos e logs de agentes - [World Markets Calendar e 30+ ECB FX Rates API](https://grid402.online/api/v1/global-markets?market=US): Calendario de liquidacao de bolsas mundiais (US NYSE/Fed, EU TARGET2, UK LSE, BR B3) + 30+ moedas oficiais do Banco Central Europeu (ECB) - [x402 Prepaid Session Pass API](https://grid402.online/api/v1/pass): Emissao de passe pre-pago M2M (1 credito = 0.0050 USDC: Starter 2 USDC = 400 creditos, Pro 5 USDC = 1.000 creditos, Fleet 20 USDC = 5.000 + 1.000 bonus = 6.000 creditos) para execucao em <15ms sem espera de bloco (`X-Payment: pass_g402_...`) - [Session Pass Balance and Spend Controls API](https://grid402.online/api/v1/pass/balance): Consulta gratuita de saldo (`remaining_credits`, `daily_credit_limit`, `credits_used_today`, `allowed_endpoints`, `expires_at`), controles de gasto (`POST /api/v1/pass/limits`) e extrato Zero-PII CSV/JSON em `GET /api/v1/pass/statement` (ultimos 200 eventos) e `/payment-dashboard` ## SDKs and Agent Frameworks - [Python SDK (PyPI)](https://pypi.org/project/grid402/): Pacote oficial grid402 para Python com suporte a Pydantic e Coinbase AgentKit - [Node.js and TypeScript SDK (npm)](https://www.npmjs.com/package/grid402): Pacote oficial grid402 no npm com suporte hibrido ESM e CommonJS - [Model Context Protocol Server (npm)](https://www.npmjs.com/package/grid402-mcp): Servidor MCP oficial para Claude Desktop, Cursor e Smithery - [Coinbase AgentKit Providers](https://github.com/oliveiratc/Grid402/tree/main/integrations/agentkit): Provedores de acoes com autoliquidacao on-chain para carteiras CDP ## Micropayment Protocol Details - Rede e Chain ID: Base Mainnet (Chain ID 8453) - Tarifa Padrao por Requisicao: 0.0050 USDC = 1 credito (Sancoes e Simples: 0.0100 USDC = 2 creditos, Domain Audit e Market Snapshot: 0.0150 USDC = 3 creditos, CNPJ, LEI, OFAC e KYB Audit: 0.0200 USDC = 4 creditos, Compliance 360: 0.0300 USDC = 6 creditos) - Formas de Liquidacao Suportadas: 1) Protocolo x402 v2 padrao (M2M Gasless): Envie a autorizacao assinada EIP-3009 em base64 no cabecalho `PAYMENT-SIGNATURE` ou `X-Payment` (esquema `exact`). O Grid402 valida e liquida via facilitador retornando o recibo em `PAYMENT-RESPONSE`. 2) Session Pass Pre-Pago (<15ms, `1 credito = 0.0050 USDC`): Adquira creditos em lote (Starter 2 USDC = 400 creditos, Pro 5 USDC = 1.000 creditos, Fleet 20 USDC = 5.000 + 1.000 bonus = 6.000 creditos) e reutilize o token `pass_g402_...` no cabecalho `X-Payment` sem latencia on-chain. Suporta teto diario (`daily_credit_limit`), whitelist de rotas (`allowed_endpoints`) e consulta gratuita de saldo em `GET /api/v1/pass/balance`. 3) Transferencia Direta On-Chain: Envie o valor em USDC na Base para a carteira do oraculo (`0xa592625adbceb8e025ac383f1a3fd8ebb6a63f90`) e repita a chamada com `X-Payment: 0x`. - Idempotencia Financeira M2M (`Idempotency-Key`): Envie `Idempotency-Key: ` nas rotas pagas `/api/v1/*` (TTL 300s) para garantir que retentativas de rede devolvam a mesma resposta assinada (`X-Idempotent-Replay: true`) sem debitar creditos duplicados. - Proveniencia e Auditoria (`_meta` + `_oracle_proof`): Toda resposta HTTP 200 paga inclui o bloco `_meta` (`upstream_source`, `fetched_at`, `cache_ttl_sec`, `operator`, `oracle_wallet`) assinado dentro do digest canonico ECDSA secp256k1. - [Base Mainnet Scanner](https://basescan.org/address/0xa592625adbceb8e025ac383f1a3fd8ebb6a63f90): Carteira oraculo recebedora de micropagamentos (0xa592625adbceb8e025ac383f1a3fd8ebb6a63f90) - [USDC Contract on Base](https://basescan.org/token/0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913): Contrato oficial de USDC na rede Base Mainnet (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) ## Cryptographic Proof of Data (Verifiable Oracle) - Todas as respostas tecnicas liberadas com pagamento on-chain ou modo Sandbox incluem a chave `_oracle_proof`. - Atestacao: Assinatura digital ECDSA secp256k1 e hash SHA-256 do payload canonico, permitindo que agentes de IA e contratos inteligentes verifiquem localmente a autenticidade dos dados da carteira oraculo (0xa592625adbceb8e025ac383f1a3fd8ebb6a63f90). - Endpoint de Verificacao: `POST /api/v1/verify` (ou `GET /api/v1/verify?payload=...`) valida sem estado qualquer resposta com assinatura em menos de 1 ms via motor OpenSSL em C (limite maximo de 64 KB). Retorna `valid: true/false`, `payload_hash`, `oracle_address`, `timestamp` e `verification_time_ms`. ## Data Protection e Open Data Legal Compliance (LGPD, GDPR, CCPA e Public Domain) - **Zero-PII Architecture (LGPD Art. 1º e GDPR Recital 14):** O Grid402 processa estritamente registros de Pessoas Juridicas (entidades corporativas), fatos macroeconomicos e telemetria de protocolos de rede. Nas consultas de CNPJ (`/api/v1/cnpj`, `/api/v1/compliance`), o sistema filtra e descarta na origem qualquer dado pessoal de pessoas fisicas (sem QSA/socios, sem CPF, sem telefones ou e-mails privados). - **Pseudonimizacao e Zero-Retention (LGPD Art. 13 e GDPR Art. 25):** Enderecos IP em metricas operacionais sao truncados (`xxx.xxx`), o controle de taxa de Sandbox utiliza hash criptografico `HMAC-SHA256` e o endpoint `/api/v1/notarize` processa dados exclusivamente em memoria RAM volatil para gerar o digest `SHA-256`, sem reter ou exibir o texto bruto (`zero_retention_policy: STRICT_STATELESS_HASH_ONLY`). - **Direito de Uso de Informacoes Publicas e Licencas Abertas (`legal_license` em cada JSON):** - `GLEIF LEI (/api/v1/lei)`: Licenca **CC0 1.0 Universal (Public Domain Dedication)**, padrao ISO 17442. - `OFAC SDN e ONU (/api/v1/ofac)`: Dominio Publico Federal dos EUA (**17 U.S.C. § 105**) e Listas Consolidadas do Conselho de Seguranca da ONU. - `Mercados Globais, Cambio e Cripto (/api/v1/global-markets, /api/v1/forex, /api/v1/crypto)`: Diretiva Europeia de Dados Abertos (**EU Directive 2019/1024 - ECB Reference Rates**), Decreto nº 8.777/2016 (BCB) e fatos economicos de mercado livres de copyright (**17 U.S.C. § 102(b)** e **Lei nº 9.610/1998 Art. 8º, I**). - `Registros Corporativos, Fiscais e Calendarios (/api/v1/cnpj, /api/v1/sanctions, /api/v1/simples, /api/v1/compliance, /api/v1/indicators, /api/v1/holidays, /api/v1/workdays, /api/v1/cep)`: Lei de Acesso a Informacao (**Lei nº 12.527/2011 - LAI**), Politica Nacional de Dados Abertos (**Decreto nº 8.777/2016**), Lei Anticorrupcao (Lei nº 12.846/2013) e algoritmos matematicos de calendario (Lei nº 9.610/1998 Art. 8º, II e IV). - `Protocolos de Rede (/api/v1/dns, /api/v1/ssl, /api/v1/asn, /api/v1/notarize)`: Padroes abertos IETF (RFC 1035, RFC 5280, RFC 4271 e RFC 8785). - **Propriedade Intelectual e Direitos Reservados da Plataforma:** © 2026 Grid402 Network Intelligence. Todos os direitos reservados (Lei nº 9.609/1998, Lei nº 9.610/1998 e Convencao de Berna). O software da plataforma, motor de liquidacao HTTP 402, arquitetura de Session Pass, marca e interface sao de propriedade exclusiva do Grid402. Os dados tecnicos retornados pertencem ao dominio publico / fontes governamentais abertas.