Every API here is available over the APIs.io API and to AI agents over MCP.
{
"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" }
}
}
}
}
}