openData StudioEnglish
Rico: só vantagem pra investir 图标

Rico 数据 API：carteira、Tesouro Direto 与卡片额度

RICO.COM.VC · 银行 3.9 ★

在 Google Play 中打开

Rico: só vantagem pra investir 是 RICO.COM.VC 的安卓券商客户端，同属 XP Inc 零售 DTVM，对外品牌为 Rico（法人 XP Investimentos CCTVM，rico.com.vc）。散户登录后开 Rico 账户，浏览每月 Rentabilíssimas 固收货架——Tesouro Direto、CDB、LCI、LCA、CRI、CRA——以及基金、FIIs、BDRs、迷你合约与零佣金的 B3 股票，在 home broker 上跑 Super Daytrade，用 Rico 数字账户做 Pix、工资入账与账单，并在 Rico Card 上拿最高 1% Investback。ChartIQ 行情图、Riconnect 分析师内容、FaceTec 身份核验、consórcio 与 Open Finance 授权围着同一份 carteira。应用只服务巴西（Play 评分 3.9，约 27.1 万条评分），与 XP Investimentos、BTG Pactual、NuInvest、Inter Invest、Ágora 争夺 CVM 监管下的经纪用户。

组合手数把 quota 与 quantity 标在 accountId 和 walletId 旁，B3 自选行用 ticker，COE 票据带 yield。入驻看 registrationStatus，档案带 customerID、email 与 document；数字账户透支返回 status 与 enabled。财富看板、Open Finance 聚合与 Rico Card 额度提醒会用到这些对象，openData Studio 把它们做成可调用的开放数据。

应用截图

  • Rico: só vantagem pra investir 应用截图 1
  • Rico: só vantagem pra investir 应用截图 2
  • Rico: só vantagem pra investir 应用截图 3
  • Rico: só vantagem pra investir 应用截图 4
  • Rico: só vantagem pra investir 应用截图 5
  • Rico: só vantagem pra investir 应用截图 6

API 端点一览

以下端点与请求/响应示例均依据应用界面推导重构，为示意说明，并非实际抓包。

  • 签发 OAuth 令牌

    POST /v1/investor/sessions/token openbanking

    为后续 carteira 调用签发零售 Rico 会话的 accessToken 与 refreshToken。

    认证方式： OAuth 令牌请求（无需事先 Bearer）。

    • accessToken
    • refreshToken
    POST /v1/investor/sessions/token HTTP/1.1
Content-Type: application/json

{}
    {
  "accessToken": "eyJhbGciOiJSUzI1NiJ9.access",
  "refreshToken": "eyJhbGciOiJSUzI1NiJ9.refresh"
}

  • 签发 DTVM OAuth 令牌

    POST /v1/investor/sessions/dtvm-token openbanking

    为 Rico CCTVM 会话签发 DTVM 会话的 accessToken 与 refreshToken。

    认证方式： DTVM 会话变体上的 OAuth 令牌请求（无需事先 Bearer）。

    • accessToken
    • refreshToken
    POST /v1/investor/sessions/dtvm-token HTTP/1.1
Content-Type: application/json

{}
    {
  "accessToken": "eyJhbGciOiJSUzI1NiJ9.dtvm",
  "refreshToken": "eyJhbGciOiJSUzI1NiJ9.refresh"
}

  • 访问控制器用户

    GET /v1/investor/sessions/me opendata

    读取 Rico 登录后访问控制器上的已登录用户。

    认证方式： 来自 POST /v1/investor/sessions/token 的 Bearer accessToken。

    GET /v1/investor/sessions/me HTTP/1.1
Authorization: Bearer <accessToken>
    {}

  • 组合汇总

    GET /v1/holdings/overview openfinance

    读取 carteira 快照：持仓首页上的 accountId、walletId、quota 与 quantity。

    认证方式： 来自 POST /v1/investor/sessions/token 的 Bearer accessToken。

    • accountId
    • walletId
    • quota
    • quantity
    GET /v1/holdings/overview HTTP/1.1
Authorization: Bearer <accessToken>
    {
  "accountId": "12345678",
  "walletId": "w-9f21",
  "quota": 1500.25,
  "quantity": 200
}

  • 组合风险

    GET /v1/holdings/risk-profile openfinance

    读取与组合汇总同一 accountId 绑定的风险视图。

    认证方式： 来自 POST /v1/investor/sessions/token 的 Bearer accessToken。

    • accountId
    • status
    GET /v1/holdings/risk-profile HTTP/1.1
Authorization: Bearer <accessToken>
    {
  "accountId": "12345678",
  "status": "OK"
}

  • 自选代码

    GET /v1/market/watchlist opendata

    列出交易与行情屏使用的股票自选 ticker 行。

    认证方式： 来自 POST /v1/investor/sessions/token 的 Bearer accessToken。

    • ticker
    GET /v1/market/watchlist HTTP/1.1
Authorization: Bearer <accessToken>
    {
  "tickers": [
    {"ticker": "PETR4"},
    {"ticker": "VALE3"}
  ]
}

  • 投资首页

    GET /v1/home/investments opendata

    加载产品货架之上的财富层投资首页。

    认证方式： 来自 POST /v1/investor/sessions/token 的 Bearer accessToken。

    GET /v1/home/investments HTTP/1.1
Authorization: Bearer <accessToken>
    {}

  • 首页投资横幅

    GET /v1/home/investments/promos opendata

    返回投资首页的横幅位。

    认证方式： 来自 POST /v1/investor/sessions/token 的 Bearer accessToken。

    GET /v1/home/investments/promos HTTP/1.1
Authorization: Bearer <accessToken>
    {}

  • 国债货架头

    GET /v1/shelves/treasury/header openfinance

    加载 Tesouro Direto 货架头，供国债产品浏览。

    认证方式： 来自 POST /v1/investor/sessions/token 的 Bearer accessToken。

    GET /v1/shelves/treasury/header HTTP/1.1
Authorization: Bearer <accessToken>
    {}

  • 基金货架筛选

    GET /v1/shelves/funds/filters openfinance

    返回基金货架筛选，含 bypassSuitability 标记。

    认证方式： 来自 POST /v1/investor/sessions/token 的 Bearer accessToken。

    • bypassSuitability
    GET /v1/shelves/funds/filters HTTP/1.1
Authorization: Bearer <accessToken>
    {
  "bypassSuitability": false
}

  • 固收筛选选项

    GET /v1/shelves/fixed-income/filters openfinance

    加载固定收益货架的筛选选项（CDB、LCI、LCA、CRI、CRA 与 Rentabilíssimas）。

    认证方式： 来自 POST /v1/investor/sessions/token 的 Bearer accessToken。

    GET /v1/shelves/fixed-income/filters HTTP/1.1
Authorization: Bearer <accessToken>
    {}

  • COE 收益资产

    GET /v1/shelves/structured-notes/assets openfinance

    列出 COE（结构化票据）资产及其 yield，供货架展示。

    认证方式： 来自 POST /v1/investor/sessions/token 的 Bearer accessToken。

    • ticker
    • yield
    GET /v1/shelves/structured-notes/assets HTTP/1.1
Authorization: Bearer <accessToken>
    {
  "assets": [
    {"ticker": "COE-1", "yield": 12.4}
  ]
}

  • 数字账户透支状态

    GET /v1/accounts/me/overdraft openbanking

    读取已登录 Rico 数字账户客户的透支 status 与 enabled。

    认证方式： 来自 POST /v1/investor/sessions/token 的 Bearer accessToken。

    • status
    • enabled
    GET /v1/accounts/me/overdraft HTTP/1.1
Authorization: Bearer <accessToken>
    {
  "status": "AVAILABLE",
  "enabled": true
}

  • Rico Card 首页额度

    GET /v1/cards/me/limit openbanking

    读取已登录客户 Rico Card 首页额度（Investback 卡）。

    认证方式： 来自 POST /v1/investor/sessions/token 的 Bearer accessToken。

    GET /v1/cards/me/limit HTTP/1.1
Authorization: Bearer <accessToken>
    {}

  • 导航档案

    GET /v1/investor/me/profile opendata

    返回移动优先导航档案：customerID、email、document 与 phone。

    认证方式： 来自 POST /v1/investor/sessions/token 的 Bearer accessToken。

    • customerID
    • email
    • document
    • phone
    GET /v1/investor/me/profile HTTP/1.1
Authorization: Bearer <accessToken>
    {
  "customerID": "c-4412",
  "email": "[email protected]",
  "document": "12345678901",
  "phone": "+5511999990000"
}

  • 个人资料入驻状态

    GET /v1/onboarding/personal-data opendata

    读取个人资料入驻步骤的 registrationStatus。

    认证方式： 来自 POST /v1/investor/sessions/token 的 Bearer accessToken。

    • registrationStatus
    GET /v1/onboarding/personal-data HTTP/1.1
Authorization: Bearer <accessToken>
    {
  "registrationStatus": "COMPLETE"
}

数据类别

  • 持仓
  • 自选
  • 国债
  • 基金
  • 固收
  • 结构化票据
  • 透支
  • 卡片
  • 档案
  • 入驻
  • 横幅

数据使用场景与案例

  • 持仓看板

    家办或理财看板从组合汇总拉取带 accountId 的 quota 与 quantity，并叠上同一 walletId 的组合风险 status。

  • 自选与 COE 收益同步

    研究终端镜像股票自选的 ticker 行，并按 yield 拼接 COE 资产，覆盖结构化票据。

  • 投资首页目录

    配置人员把财富层投资首页、N1_HOME_INVESTIMENTO 横幅、Tesouro 货架头与基金筛选（含 bypassSuitability）抄进内部产品矩阵。

  • 卡片额度与透支提醒

    资金机器人读取数字账户透支 status、enabled 与 Rico Card 首页额度，任一翻转就通知运营。

常见问题

Rico 的组合汇总返回哪些持仓字段？

组合汇总在持仓首页给出 accountId、walletId、quota 与 quantity，并有同一 accountId 上的风险视图。

Rico 如何鉴权接口调用？

零售会话从 OAuth 令牌路由签发 accessToken 与 refreshToken；并行的 DTVM 路径令牌覆盖 CCTVM 会话。之后的 carteira、货架与卡片调用把 accessToken 作为 Bearer 发送。

除股票外还暴露哪些投资货架？

Tesouro Direto 有国债货架头；基金与固收暴露货架筛选（含 bypassSuitability），COE 资产含 yield。财富层投资首页与 N1_HOME_INVESTIMENTO 横幅叠在这些货架之上。

应用是否覆盖银行产品而不只是经纪？

是。数字账户透支报告 status 与 enabled，Rico Card 首页返回与 Investback 配套的额度，客户端里还有 Pix 与 Open Finance 授权屏。

与 Rico: só vantagem pra investir 相似的应用

  • XP Investimentos — XP Investimentos 是 XP Inc. 的巴西券商应用，把投资、数字账户、Pix 与支付放在同一登录里。
  • BTG Pactual Investimentos — BTG Pactual Investimentos 是 BTG Pactual 面向巴西零售的投资应用，覆盖固收与股票、FIIs、BDRs，并宣传股票、FIIs 与 BDRs 零佣金。
  • Nubank — 努班克把券商收进主应用 Nubank：从 30 雷亚尔起买 Tesouro Direto，以及 CDB、基金、FIIs、ETF 与巴西股票，并宣传免佣金。
  • Inter — Inter 的 Super App 内置券商，可从 1 雷亚尔起买 CDB，并交易 Tesouro Direto、基金、加密货币以及巴西与海外股票。
  • Ágora Investimentos — Ágora Investimentos 是布拉德斯科（Bradesco）投资子公司的应用，把固收到股票的产品与独立的股市交易环境放在同一客户端。
  • Santander Corretora — Santander Corretora（原 Toro Investimentos）是桑坦德银行的巴西券商应用，覆盖固收、B3 股票、基金、BDR 与 ETF，并宣传零佣金。
  • Clear — Clear 是 XP Inc. 旗下偏交易的券商应用，用于 B3 股票、ETF、迷你合约与 Tesouro Direto，订单接入 Home Broker，并宣传零佣金。

更多银行类应用

相关主题

  • Rico API
  • Rico carteira 持仓
  • Tesouro Direto
  • Rico Card 额度
  • B3 自选
  • 巴西券商数据
  • COE yield
  • Rico 数字账户透支

需要集成这个 App 的数据 API？

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起，或托管 API 按调用计费。告诉我们您需要的数据即可。

  • 每个项目均签 NDA 与 SOW
  • 3–7 天交付
  • 验收通过后才付款
  • 仅在授权范围内作业

获取报价