{ "openapi": "3.1.0", "info": { "title": "AGENTUM — APIs Brasil", "version": "1.0.0", "description": "APIs brasileiras pagas por chamada via x402 (USDC, Base mainnet): dado público agregado, pronto pra um agente de IA consumir numa chamada só.", "x-guidance": "Use POST /business-intelligence com {\"cnpj\": \"<14 dígitos>\"} pra receber cadastro, atividades, endereço e sinais objetivos de uma empresa brasileira consolidados numa resposta estruturada só. Use GET /verificar-cnpj?cnpj=<14 dígitos> pra checar situação cadastral, Simples Nacional e endereço de uma empresa brasileira antes de fechar negócio. Use GET /verificar-cep?cep=<8 dígitos> pra validar um endereço brasileiro antes de despachar algo. Use GET /taxas-brasil (sem parâmetro) pra taxas oficiais do Banco Central (Selic, CDI, dólar comercial) num JSON só. Todas exigem pagamento x402 em USDC na rede Base (eip155:8453).", "contact": { "email": "agentumcomercial@carmozinog.com" } }, "servers": [{ "url": "https://agentum.lat" }], "paths": { "/business-intelligence": { "post": { "operationId": "businessIntelligence", "summary": "Inteligência empresarial por CNPJ", "description": "Consolida cadastro, atividades, endereço e sinais objetivos de uma empresa brasileira numa resposta estruturada pronta para sistemas e agentes.", "tags": ["Business Intelligence"], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [{ "x402": {} }] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "cnpj": { "type": "string", "description": "CNPJ brasileiro, 14 dígitos, apenas números" } }, "required": ["cnpj"] }, "example": { "cnpj": "68964713000109" } } } }, "responses": { "200": { "description": "Cadastro, atividades, endereço e sinais objetivos consolidados", "content": { "application/json": { "schema": { "type": "object", "properties": { "company": { "type": "object" }, "registration": { "type": "object" }, "address": { "type": "object" }, "activities": { "type": "array", "items": { "type": "string" } }, "signals": { "type": "array", "items": { "type": "string" } }, "summary": { "type": "string" }, "sources": { "type": "array", "items": { "type": "string" } }, "confidence": { "type": "number" }, "queriedAt": { "type": "string" } } }, "example": { "company": { "cnpj": "68.964.713/0001-09", "razaoSocial": "AGENTUM LTDA", "nomeFantasia": "AGENTUM", "naturezaJuridica": "206-2 - Sociedade Empresária Limitada", "porte": "MICRO EMPRESA", "capitalSocial": 10000 }, "registration": { "situacao": "ATIVA", "dataSituacao": "03/09/2026", "dataAbertura": "03/09/2026", "optanteSimples": null, "optanteMei": null }, "address": { "logradouro": "R TEREZINHA DUQUE BORBOREMA", "numero": "289", "complemento": null, "bairro": "CONJUNTO HABITACIONAL AUREA MENDES GIMENES", "cep": "14.178-210", "municipio": "SERTAOZINHO", "uf": "SP" }, "activities": ["Desenvolvimento e licenciamento de programas de computador customizáveis", "Consultoria em tecnologia da informação"], "signals": ["Empresa aberta há menos de 1 ano"], "summary": "AGENTUM LTDA (CNPJ 68.964.713/0001-09), situação cadastral ATIVA, atividade principal em desenvolvimento de software, localizada em Sertãozinho/SP.", "sources": ["receitaws"], "confidence": 0.75, "queriedAt": "2026-09-05T18:24:24.136Z" } } } }, "402": { "description": "Payment Required" } } } }, "/verificar-cnpj": { "get": { "operationId": "verificarCnpj", "summary": "Verificação de CNPJ brasileiro em tempo real", "tags": ["Verification"], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "protocols": [{ "x402": {} }] }, "parameters": [ { "name": "cnpj", "in": "query", "required": true, "schema": { "type": "string", "description": "CNPJ brasileiro, 14 dígitos, apenas números" }, "example": "68964713000109" } ], "responses": { "200": { "description": "Situação cadastral, Simples Nacional e endereço da empresa", "content": { "application/json": { "schema": { "type": "object", "properties": { "cnpj": { "type": "string" }, "razao_social": { "type": "string" }, "situacao": { "type": "string" }, "data_situacao": { "type": "string" }, "abertura": { "type": "string" }, "natureza_juridica": { "type": "string" }, "uf": { "type": "string" }, "municipio": { "type": "string" }, "atividade_principal": { "type": "string" }, "fonte": { "type": "string" } } }, "example": { "cnpj": "68.964.713/0001-09", "razao_social": "AGENTUM LTDA", "situacao": "ATIVA", "data_situacao": "03/09/2026", "abertura": "03/09/2026", "natureza_juridica": "206-2 - Sociedade Empresária Limitada", "uf": "SP", "municipio": "SERTAOZINHO", "atividade_principal": "Desenvolvimento e licenciamento de programas de computador customizáveis", "fonte": "receitaws" } } } }, "402": { "description": "Payment Required" } } } }, "/verificar-cep": { "get": { "operationId": "verificarCep", "summary": "Validação de endereço/CEP brasileiro em tempo real", "tags": ["Verification"], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "protocols": [{ "x402": {} }] }, "parameters": [ { "name": "cep", "in": "query", "required": true, "schema": { "type": "string", "description": "CEP brasileiro, 8 dígitos, apenas números" }, "example": "01310100" } ], "responses": { "200": { "description": "Endereço completo", "content": { "application/json": { "schema": { "type": "object", "properties": { "cep": { "type": "string" }, "logradouro": { "type": "string" }, "bairro": { "type": "string" }, "municipio": { "type": "string" }, "uf": { "type": "string" }, "regiao": { "type": "string" }, "ddd": { "type": "string" }, "fonte": { "type": "string" } } }, "example": { "cep": "01310-100", "logradouro": "Avenida Paulista", "bairro": "Bela Vista", "municipio": "São Paulo", "uf": "SP", "regiao": "Sudeste", "ddd": "11", "fonte": "viacep" } } } }, "402": { "description": "Payment Required" } } } }, "/taxas-brasil": { "get": { "operationId": "taxasBrasil", "summary": "Taxas oficiais do Brasil em tempo real (Selic, CDI, dólar comercial)", "tags": ["Finance"], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "protocols": [{ "x402": {} }] }, "responses": { "200": { "description": "Taxas oficiais atualizadas", "content": { "application/json": { "schema": { "type": "object", "properties": { "selic_meta_aa": { "type": "object", "properties": { "valor": { "type": "string" }, "data": { "type": "string" }, "unidade": { "type": "string" } } }, "cdi_ad": { "type": "object", "properties": { "valor": { "type": "string" }, "data": { "type": "string" }, "unidade": { "type": "string" } } }, "dolar_comercial_venda": { "type": "object", "properties": { "valor": { "type": "string" }, "data": { "type": "string" }, "unidade": { "type": "string" } } }, "fonte": { "type": "string" } } }, "example": { "selic_meta_aa": { "valor": "14.00", "data": "16/09/2026", "unidade": "% ao ano" }, "cdi_ad": { "valor": "0.051660", "data": "03/09/2026", "unidade": "% ao dia" }, "dolar_comercial_venda": { "valor": "5.1253", "data": "04/09/2026", "unidade": "BRL por USD" }, "fonte": "Banco Central do Brasil (SGS)" } } } }, "402": { "description": "Payment Required" } } } } } }