关于 Renda Fixa
Renda Fixa 是用于比较巴西固定收益证券的 API 和 MCP 服务,涵盖多家银行与券商的产品,并提供税后收益及依据 Boletim Focus 预测计算的实际收益。
主要功能
- 01搜索多种固定收益产品
- 02按净收益、实际收益、期限或最低投资额排序
- 03按发行方、税务状态和 FGC 保障筛选
- 04以 JSON 或 CSV 导出结果
- 05每日更新数据
适用场景
- 01比较享有税收豁免且有 FGC 保障的债券
- 02按期限或最低投资额查找债券
- 03将债券列表导入电子表格
MCP 相关
远程 MCP 服务位于 https://rendafixa.api.br/mcp,提供 search_bonds 和 list_issuers。MCP 客户端可筛选和排序债券;无密钥时仅返回预览数据。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://rendafixa.api.br/mcpclaude mcp add --transport http br-api-rendafixa-renda-fixa https://rendafixa.api.br/mcp{"mcpServers":{"br-api-rendafixa-renda-fixa":{"type":"http","url":"https://rendafixa.api.br/mcp"}}}在 Cursor 中打开{"servers":{"br-api-rendafixa-renda-fixa":{"type":"http","url":"https://rendafixa.api.br/mcp"}}}在 VS Code 中打开{"mcpServers":{"br-api-rendafixa-renda-fixa":{"type":"http","url":"https://rendafixa.api.br/mcp"}}}{"mcpServers":{"br-api-rendafixa-renda-fixa":{"serverUrl":"https://rendafixa.api.br/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
https://rendafixa.api.br/mcp需要授权工具
2| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| fgc | boolean | 否 | true:仅限受 FGC 担保的债券(每个 CPF、每家机构最高 R$ 250,000)。 |
| bank | array | 否 | 发行方/经纪商代码,参见 list_issuers(例如:341 Itaú、77 Inter、208 BTG)。 |
| index | array | 否 | 指数类型:cdi*(CDI 的百分比)、cdi+(CDI + 利差)、ipca*、ipca+(IPCA + 利差)、selic*、selic+、pre(固定利率)。 |
| limit | integer | 否 | 返回的债券数量(最多 50)。 |
| product | array | 否 | 产品类型:cdb、lci、lca、cri、cra、deb(debênture)、tpf/td(Tesouro Direto)、lf(letra financeira)、misc。 |
| sort_by | enum | 否 | net_return / real_return:从高到低。maturity:从最近到最远。min_investment:从低到高。net_return | real_return | maturity | min_investment |
| tax_free | boolean | 否 | true:仅限免缴 IR 的债券(LCI、LCA、CRI、CRA、激励型 debêntures)。false:仅限应税债券。 |
| max_years | number | 否 | 仅限从今天起在指定年数内到期的债券。 |
| max_min_investment | number | 否 | 仅限最低投资额不超过此 BRL 金额的债券。 |
详细介绍
Renda Fixa API
一次调用获取巴西固定收益证券——来自多家银行和经纪商的 CDB、LCI、LCA、CRI、CRA、债券和 Tesouro Direto,并已根据《Focus 公报》(巴西中央银行)的预测计算出所得税后的净回报和高于 IPCA 的实际收益。每日更新。
- REST/JSON —
GET https://rendafixa.api.br/api/ - CSV 电子表格 — Google Sheets 和 Excel,无需编程
- MCP 服务 — 可在 Claude、ChatGPT、Cursor 和其他 AI 助手中使用
- OpenAPI 3.1 —
openapi.json
📖 文档:https://rendafixa.api.br/docs/api · 💳 套餐:https://rendafixa.api.br/pricing
立即试用(无需密钥)
无需密钥,API 会返回 5 个证券的预览:
curl "https://rendafixa.api.br/api/"
{
"response": { "status": "preview", "description": "No API key provided. Showing up to 5 bonds as a preview." },
"bonds": [
{
"name": "CDB 360 DIAS",
"bank": 77,
"bank_name": "Banco Inter",
"product": "cdb",
"index": "cdi*",
"rate": 1.05,
"fgc_protection": true,
"tax_free": false,
"min_investment": 100,
"maturity_date": "2027-05-08",
"rating": "AA+",
"net_annualized_return": 0.1165,
"real_annualized_return": 0.0676
}
]
}
使用有效订阅账户的密钥,响应将包含所有证券。请在 rendafixa.api.br/user/api-keys 生成密钥。
curl -H "Authorization: Bearer rf_SUA_CHAVE" \
"https://rendafixa.api.br/api/?product=lci,lca&tax_free=1&fgc=1"
筛选条件
| 参数 | 值 | |
|---|---|---|
product | cdb、lci、lca、cri、cra、deb、tpf、td、lf、misc | 以逗号分隔的列表 |
index | cdi*、cdi+、ipca*、ipca+、selic*、selic+、pre | 将 + 编码为 %2B |
bank | 数字代码 | 例如:341 Itaú、77 Inter、208 BTG |
tax_free | 0 / 1 | 仅征税 / 仅免征所得税 |
fgc | 0 / 1 | 无 / 有 FGC 保障 |
format | json / csv |
利率和回报均为小数:0.1165 = 11.65% 年利率。各字段详情及回报计算方式请参阅文档。
示例
收益最高的免征所得税证券,无需任何依赖:
- Python:
examples/python/melhores_isentos.py - JavaScript(Node 18+):
examples/javascript/melhores-isentos.mjs
RENDAFIXA_KEY=rf_SUA_CHAVE python examples/python/melhores_isentos.py
电子表格
Google Sheets(葡萄牙语电子表格):
=IMPORTDATA("https://rendafixa.api.br/api/?format=csv&locale=pt-BR&key=rf_SUA_CHAVE")
在英文电子表格中,删除 &locale=pt-BR。筛选条件可在同一 URL 中使用:&product=lci,lca&tax_free=1。
Excel:数据 → 从 Web 获取 → 粘贴上面的 URL。
AI 助手(MCP)
该 API 也是一个远程 MCP 服务:https://rendafixa.api.br/mcp。添加后,只需提问——“哪种有 FGC 保障、期限不超过 2 年的 LCI 收益最高?”。
Claude Code
claude mcp add --transport http rendafixa https://rendafixa.api.br/mcp \
--header "Authorization: Bearer rf_SUA_CHAVE"
Cursor(.cursor/mcp.json)和其他支持 JSON 配置的客户端
{
"mcpServers": {
"rendafixa": {
"url": "https://rendafixa.api.br/mcp",
"headers": { "Authorization": "Bearer rf_SUA_CHAVE" }
}
}
}
Claude.ai 和 ChatGPT(仅接受 URL 的自定义连接器):https://rendafixa.api.br/mcp?key=rf_SUA_CHAVE
工具:search_bonds(按净回报、实际收益、到期日或最低投资金额筛选和排序)和 list_issuers(银行及代码)。无需密钥时会显示预览。
许可证
本仓库中的示例采用 MIT 许可证。API 的使用须遵守 Renda Fixa 的套餐和条款。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。