openData StudioEnglish
XP Investimentos 图标

XP Investimentos 数据 API：持仓、国债与 XP Card

XP Investimentos · 银行

在 Google Play 中打开

XP Investimentos 是 XP Inc. 面向巴西 DTVM 的安卓券商客户端，品牌为 Minha Carteira。散户与投顾服务客户登录后盯 B3 股票、下单、维护自选、浏览基金、COE、Tesouro Direto、养老（previdência）与 consórcio，做适合度问卷，接入 Open Finance，激活 XP Card，查看数字账户透支与循环贷首页，并完成 KYC。ChartIQ 行情图与报价、委托流围着同一份 carteira。应用只服务巴西，与 BTG Pactual、NuInvest、Inter Invest、Ágora 争夺 CVM 监管下的经纪用户。

配额与数量落在 carteira 汇总上，紧挨 accountId，自选行用 ticker，COE 资产带 yield。入驻看 registrationStatus，档案带 customerID、email 与 document；数字账户透支返回 status 与 enabled，XP Card 首页给出额度。财富看板、Open Finance 聚合与卡片额度提醒会用到这些对象，openData Studio 把它们做成可调用的开放数据。

应用截图

  • XP Investimentos 应用截图 1
  • XP Investimentos 应用截图 2
  • XP Investimentos 应用截图 3
  • XP Investimentos 应用截图 4
  • XP Investimentos 应用截图 5
  • XP Investimentos 应用截图 6

API 端点一览

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

  • 签发会话令牌

    POST /v1/brokerage/sessions/token openbanking

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

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

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

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

  • 签发投顾会话令牌

    POST /v1/brokerage/sessions/advisor-token openbanking

    为 IFA / 投顾服务客户会话签发投顾渠道的 accessToken 与 refreshToken。

    认证方式： 投顾渠道上的令牌请求（无需事先 Bearer）。

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

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

  • 组合汇总

    GET /v1/holdings/overview openfinance

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

    认证方式： 来自 POST /v1/brokerage/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/brokerage/sessions/token 的 Bearer accessToken。

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

  • 自选代码

    GET /v1/watchlists/items opendata

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

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

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

  • 国债货架头

    GET /v1/shelves/treasury/header openfinance

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

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

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

  • 基金货架筛选

    GET /v1/shelves/funds/filters openfinance

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

    认证方式： 来自 POST /v1/brokerage/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

    加载固定收益货架的筛选选项。

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

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

  • 股票货架筛选

    GET /v1/shelves/equities/filters openfinance

    加载客户视角的股票（可变收益）货架列表筛选。

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

    GET /v1/shelves/equities/filters HTTP/1.1
Authorization: Bearer <accessToken>
    {}

  • COE 收益资产

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

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

    认证方式： 来自 POST /v1/brokerage/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

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

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

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

  • XP Card 首页额度

    GET /v1/cards/home/limit openbanking

    读取已登录客户 XP Card 首页额度。

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

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

  • 导航档案

    GET /v1/customers/me/profile opendata

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

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

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

  • 个人资料入驻状态

    GET /v1/onboarding/personal-data/status opendata

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

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

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

  • 养老基金筛选

    GET /v1/shelves/pension/filters openfinance

    加载 previdência（Corprev）基金货架筛选。

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

    GET /v1/shelves/pension/filters HTTP/1.1
Authorization: Bearer <accessToken>
    {}

数据类别

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

数据使用场景与案例

  • 持仓看板

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

  • 自选与 COE 收益同步

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

  • 货架筛选目录

    配置人员把 Tesouro、基金、固收、股票与 Corprev 养老货架筛选（含 bypassSuitability）抄进内部产品矩阵。

  • 卡片额度与透支提醒

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

常见问题

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

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

XP Investimentos 如何鉴权接口调用？

零售会话从 DTVM OAuth 令牌路由签发 accessToken 与 refreshToken；投顾服务会话走独立投顾主机令牌。之后的 carteira、货架与卡片调用把 accessToken 作为 Bearer 发送。

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

Tesouro Direto 有国债货架头；基金、固收、股票与 Corprev 养老各自暴露货架筛选，COE 资产含 yield。

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

是。数字账户透支报告 status 与 enabled，XP Card 首页返回额度，客户端里还有 Open Finance 连接屏。

与 XP Investimentos 相似的应用

  • BTG Pactual — BTG Pactual 的数字投资平台向巴西散户提供基金、CDB、LCI、LCA 与 LF、PGBL/VGBL 私人养老金以及 COE 结构化票据，并在 2020 年推出 BTG+ 数字银行。
  • Nu Investimentos — Nubank 的投资经纪业务可买 30 雷亚尔起的 Tesouro Direto、CDB、免税 LCI/LCA、主动管理基金，以及巴西股票、ETF、FII 和 BDR 等交易所产品，并在 Nubank 应用内跟踪。
  • Inter Investimentos — Inter Investimentos 是 Banco Inter 应用内的券商，银行与经纪合一，客户可买 1 雷亚尔起的 CDB、Tesouro Direto、基金、巴西与海外股票以及加密货币。
  • Ágora Investimentos — Ágora Investimentos 是布拉德斯科银行的投资平台，提供 B3 股票、含 Tesouro Direto 与 FGC 担保品种在内的 600 多种固收、基金、COE 结构化产品和养老金。
  • Rico — Rico 是 XP Inc. 面向巴西自主投资的零售券商应用，可买股票、ETF、房地产基金（FII）和 Tesouro Direto。
  • Toro Investimentos — Toro Investimentos 是桑坦德券商在巴西的交易平台，提供 Home Broker、Profit Toro Trader 和 Profit Pro，宣传零佣金，并有面向日内交易的 DMA4 托管。

更多银行类应用

相关主题

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

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

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

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

获取报价