Trade Republic 数据 API：端点与字段

Trade Republic Bank GmbH · 银行

Trade Republic: Broker & Bank 是 Trade Republic Bank GmbH 的安卓客户端——柏林的新券商，同时经营持牌现金账户。用户用手机号加 PIN 登录后，可买卖股票、ETF、衍生品、加密资产与债券，做 Sparplan 定投，把欧元存在付息的 IBAN 现金账户，用可冻结、支持 Google Pay 的 Visa 借记卡消费，并在法国持有 Livret A 或 PEA 税务包装。首页还覆盖多组合浏览、自选、儿童账户、AVD 托管策略、公司行动与应用内客服。产品只服务欧盟，以德国为本土市场，法国与西班牙有正式应用，与 Scalable Capital、flatex、Revolut、N26 争夺希望在同一部手机上同时拥有券商和银行 IBAN 的投资者。

按 accountNumber 索引的现金账户行带有 amount 与 ISO currency，入金通道则在主收款地址上给出 iban 与 bic。定投行盖上 instrumentId、fundingCashAccNo 与 nextExecutionDate；Visa 借记卡返回 lastFourPan 以及日/月 spendDaily / atmDaily 窗口。德国 Freistellungsauftrag 状态落在免税额订单的 used 对 maximum，法国 Livret A 在 ACTIVE 时报告 balance，利息卡片则发布 currentInterestRate 与 earnedInterest。

资金、税务包装与家族办公室工具用这些字段对账现金与券商、监控定投出资、标出剩余 Steuerfreibetrag — openData Studio 把它们变成可调用的开放数据。

应用截图

API 端点一览

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

PIN 登录
POST /v1/auth/pin-sign-in openbanking
用 phoneNumber + pin 换取 sessionToken / refreshToken JWT，以及决定后续所有调用的 accountState 与 jurisdiction。
认证方式：手机号加 PIN（或密码凭据）放在请求体中。响应的 sessionToken JWT 作为后续调用的 Authorization: Bearer；refreshToken 用于轮换会话。
- phoneNumber
- pin
- subjectId
- refreshToken
- sessionToken
- accountState
- jurisdiction
- trackingId
```
POST /v1/auth/pin-sign-in HTTP/1.1
Content-Type: application/json
X-App-Version: <appVersion>
X-Client-Platform: android

{
  "phoneNumber": "+491701234567",
  "pin": "<pin>",
  "subjectId": "sub-8f21c4"
}
```
```
{
  "refreshToken": "<refreshToken>",
  "sessionToken": "<sessionToken>",
  "accountState": "ACTIVE",
  "jurisdiction": "DE",
  "trackingId": "trk-19a2b7"
}
```

刷新会话

POST /v1/auth/session-renewal openbanking

PIN 登录后签发新会话：sessionToken JWT、accountState、jurisdiction、backendFeatures 与 subjectId。

认证方式：请求体携带 subjectId；续期后的 sessionToken JWT 作为 Authorization: Bearer。

subjectId
sessionToken.value
accountState
jurisdiction
backendFeatures
trackingId

POST /v1/auth/session-renewal HTTP/1.1
Authorization: Bearer <sessionToken>
Content-Type: application/json

{
  "subjectId": "sub-8f21c4"
}

{
  "sessionToken": {
    "value": "<sessionToken>"
  },
  "accountState": "ACTIVE",
  "jurisdiction": "DE",
  "backendFeatures": ["MULTI_PORTFOLIO", "CASH_TAB"],
  "trackingId": "trk-19a2b7",
  "subjectId": "sub-8f21c4"
}

现金账户余额
GET /v1/accounts/cash/balances openbanking
读取现金页使用的各现金账户行：accountNumber、ISO currency 与 amount。
认证方式： Authorization: Bearer <sessionToken JWT>，来自登录调用，另带应用版本与平台设备头。
- accountNumber
- currency
- amount
```
GET /v1/accounts/cash/balances HTTP/1.1
Authorization: Bearer <sessionToken>
Accept: application/json
```
```
{
  "balances": [
    {
      "accountNumber": "DE89370400440532013000",
      "currency": "EUR",
      "amount": 4287.55
    }
  ]
}
```
现金账户 IBAN 明细
GET /v1/accounts/cash/{accountNumber}/deposit-details openbanking
返回现金账户的 SEPA 入金通道：accountHolder 的 name/authAccountId，以及带 iban、bic 的 paymentAddresses。
认证方式： Authorization: Bearer <sessionToken JWT>，来自登录调用，另带应用版本与平台设备头。
- accountHolder.name
- accountHolder.subType
- accountHolder.authAccountId
- paymentAddresses.primary
- paymentAddresses.details.iban
- paymentAddresses.details.bic
```
GET /v1/accounts/cash/DE89370400440532013000/deposit-details HTTP/1.1
Authorization: Bearer <sessionToken>
Accept: application/json
```
```
{
  "accountHolder": {
    "name": "Anna Schmidt",
    "subType": "PRIVATE",
    "authAccountId": "acc-7c91e2"
  },
  "paymentAddresses": [
    {
      "primary": true,
      "details": {
        "iban": "DE89370400440532013000",
        "bic": "TRBKDEBBXXX"
      }
    }
  ]
}
```

时间线交易

GET /v1/activity/feed openbanking

分页返回现金页与券商时间线行：id、timestamp、title/subtitle、status 以及 amount.value/currency。

认证方式： Authorization: Bearer <sessionToken JWT>，来自登录调用，另带应用版本与平台设备头。

id
sectionId
timestamp
title
subtitle
status
amount.value
amount.fractionDigits
amount.currency
badge

GET /v1/activity/feed?limit=20 HTTP/1.1
Authorization: Bearer <sessionToken>
Accept: application/json

{
  "items": [
    {
      "id": "evt-aa12",
      "sectionId": "2026-10",
      "timestamp": "2026-10-18T09:15:02",
      "title": "Savings plan · IWDA",
      "subtitle": "Buy · 50.00 EUR",
      "status": "EXECUTED",
      "amount": {
        "value": -50.00,
        "fractionDigits": 2,
        "currency": "EUR"
      },
      "badge": "SP"
    }
  ]
}

组合最新收益
GET /v1/portfolios/performance/summary openfinance
按市价重估多组合页头：performance.absoluteValue / relativeValue 与 currency。
认证方式： Authorization: Bearer <sessionToken JWT>，来自登录调用，另带应用版本与平台设备头。
- performance.absoluteValue
- performance.relativeValue
- currency
```
GET /v1/portfolios/performance/summary HTTP/1.1
Authorization: Bearer <sessionToken>
Accept: application/json
```
```
{
  "performance": {
    "absoluteValue": 312.40,
    "relativeValue": 0.0187
  },
  "currency": "EUR"
}
```

定投计划

GET /v1/recurring-investments openfinance

列出定投（Sparplan）行：instrumentId、amount、interval、nextExecutionDate、paused 以及出资账户 fundingCashAccNo。

认证方式： Authorization: Bearer <sessionToken JWT>，来自登录调用，另带应用版本与平台设备头。

id
createdAt
instrumentId
amount.value
amount.currency
interval
startDate
nextExecutionDate
paused
fundingCashAccNo
paymentMethodCode
instrumentType

GET /v1/recurring-investments HTTP/1.1
Authorization: Bearer <sessionToken>
Accept: application/json

{
  "plans": [
    {
      "id": "sp-441",
      "createdAt": "2025-03-12T08:00:00Z",
      "instrumentId": "IE00B4L5Y983",
      "amount": {"value": 50.00, "currency": "EUR"},
      "interval": "MONTHLY",
      "startDate": "NEXT_MONTH",
      "nextExecutionDate": "2026-11-01",
      "paused": false,
      "fundingCashAccNo": "DE89370400440532013000",
      "paymentMethodCode": "CASH",
      "instrumentType": "ETF"
    }
  ]
}

当前 Visa 借记卡
GET /v1/cards/active openbanking
读取已登录 Visa 借记卡：lastFourPan、status、cardholderName、createTime/activateTime 与 isPinSet。
认证方式： Authorization: Bearer <sessionToken JWT>，来自登录调用，另带应用版本与平台设备头。
- id
- lastFourPan
- createTime
- activateTime
- status
- cardholderName
- isPinSet
```
GET /v1/cards/active HTTP/1.1
Authorization: Bearer <sessionToken>
Accept: application/json
```
```
{
  "id": "card-aa12",
  "lastFourPan": "4242",
  "createTime": "2025-06-01T10:00:00",
  "activateTime": "2025-06-04T12:11:00",
  "status": "ACTIVE",
  "cardholderName": "ANNA SCHMIDT",
  "isPinSet": true
}
```

卡片消费限额

GET /v1/cards/limits openbanking

把 ATM 与 POS 额度拆成日/月窗口：limitAmountWithCurrency 对 currentSpendWithCurrency。

认证方式： Authorization: Bearer <sessionToken JWT>，来自登录调用，另带应用版本与平台设备头。

atmDaily.limitType
atmDaily.limitWindow
atmDaily.limitAmountWithCurrency.value
atmDaily.currentSpendWithCurrency.value
atmMonthly.limitAmountWithCurrency.value
spendDaily.limitAmountWithCurrency.value
spendMonthly.currentSpendWithCurrency.value
spendMonthly.maxAllowedLimitWithCurrency.value

GET /v1/cards/limits HTTP/1.1
Authorization: Bearer <sessionToken>
Accept: application/json

{
  "atmDaily": {
    "limitType": "ATM",
    "limitWindow": "DAILY",
    "limitAmountWithCurrency": {"value": 500.00, "currency": "EUR"},
    "currentSpendWithCurrency": {"value": 80.00, "currency": "EUR"},
    "maxAllowedLimitWithCurrency": {"value": 1000.00, "currency": "EUR"}
  },
  "atmMonthly": {
    "limitType": "ATM",
    "limitWindow": "MONTHLY",
    "limitAmountWithCurrency": {"value": 2000.00, "currency": "EUR"},
    "currentSpendWithCurrency": {"value": 240.00, "currency": "EUR"},
    "maxAllowedLimitWithCurrency": {"value": 5000.00, "currency": "EUR"}
  },
  "spendDaily": {
    "limitType": "SPEND",
    "limitWindow": "DAILY",
    "limitAmountWithCurrency": {"value": 2500.00, "currency": "EUR"},
    "currentSpendWithCurrency": {"value": 64.90, "currency": "EUR"},
    "maxAllowedLimitWithCurrency": {"value": 5000.00, "currency": "EUR"}
  },
  "spendMonthly": {
    "limitType": "SPEND",
    "limitWindow": "MONTHLY",
    "limitAmountWithCurrency": {"value": 8000.00, "currency": "EUR"},
    "currentSpendWithCurrency": {"value": 1120.40, "currency": "EUR"},
    "maxAllowedLimitWithCurrency": {"value": 15000.00, "currency": "EUR"}
  }
}

德国免税额订单
GET /v1/tax/allowances openfinance
读取 Freistellungsauftrag：type SINGLE/JOINT、amount 对 used 对 maximum、validFrom/validUntil 与 syncStatus。
认证方式： Authorization: Bearer <sessionToken JWT>，来自登录调用，另带应用版本与平台设备头。
- id
- type
- amount
- applied
- used
- maximum
- validFrom
- validUntil
- syncStatus
```
GET /v1/tax/allowances HTTP/1.1
Authorization: Bearer <sessionToken>
Accept: application/json
```
```
{
  "id": "exo-2026",
  "type": "SINGLE",
  "amount": 1000.00,
  "applied": 1000.00,
  "used": 412.30,
  "maximum": 1000.00,
  "validFrom": "2026-01-01",
  "validUntil": "2026-12-31",
  "syncStatus": "SYNCED"
}
```
已实现盈亏与分红
GET /v1/tax/realized-returns openfinance
按证券账户返回 realizedPnL 与 dividendReturn 的绝对金额与相对比例，以及 lastUpdatedTimestamp。
认证方式： Authorization: Bearer <sessionToken JWT>，来自登录调用，另带应用版本与平台设备头。
- secAccNo
- realizedPnL.absolute.value
- realizedPnL.relative
- dividendReturn.absolute.value
- dividendReturn.relative
- lastUpdatedTimestamp
```
GET /v1/tax/realized-returns HTTP/1.1
Authorization: Bearer <sessionToken>
Accept: application/json
```
```
{
  "secAccNo": "1234567890",
  "realizedPnL": {
    "absolute": {"value": 840.12, "currency": "EUR"},
    "relative": 0.064
  },
  "dividendReturn": {
    "absolute": {"value": 126.50, "currency": "EUR"},
    "relative": 0.009
  },
  "lastUpdatedTimestamp": "2026-10-18T22:01:00Z"
}
```
Livret A 状态
GET /v1/wrappers/regulated-savings/status openbanking
读取法国 Livret A 包装账户：ACTIVE/ELIGIBLE/ONBOARDING/CLOSED，ACTIVE 时带 balance.value/currency。
认证方式： Authorization: Bearer <sessionToken JWT>，来自登录调用，另带应用版本与平台设备头。
- type
- balance.value
- balance.currency
```
GET /v1/wrappers/regulated-savings/status HTTP/1.1
Authorization: Bearer <sessionToken>
Accept: application/json
```
```
{
  "type": "ACTIVE",
  "balance": {
    "value": 12500.00,
    "currency": "EUR"
  }
}
```
现金利息首页
GET /v1/accounts/cash/{accountNumber}/interest-summary openbanking
加载现金利息卡片：currentInterestRate、earnedInterest、currency、termsAccepted 与 isEligibleForInterestHike。
认证方式： Authorization: Bearer <sessionToken JWT>，来自登录调用，另带应用版本与平台设备头。
- title
- subtitle
- termsAccepted
- earnedInterest
- currency
- currentInterestRate
- isEligibleForInterestHike
- iconUrl
```
GET /v1/accounts/cash/DE89370400440532013000/interest-summary HTTP/1.1
Authorization: Bearer <sessionToken>
Accept: application/json
```
```
{
  "title": "Interest",
  "subtitle": "Paid monthly",
  "termsAccepted": true,
  "earnedInterest": 18.42,
  "currency": "EUR",
  "currentInterestRate": "2.00",
  "isEligibleForInterestHike": false,
  "iconUrl": "https://cdn.example.com/img/interest.svg"
}
```

客户个人资料

GET /v1/profile/identity-review osint

读取个人资料确认屏：status 以及姓名、电话、地址与税务居民身份等 items。

认证方式： Authorization: Bearer <sessionToken JWT>，来自登录调用，另带应用版本与平台设备头。

status
title
description
items.title
items.status
items.payload

GET /v1/profile/identity-review HTTP/1.1
Authorization: Bearer <sessionToken>
Accept: application/json

{
  "status": "CONFIRMED",
  "title": "Your details",
  "description": "Confirm name, phone and tax residencies",
  "items": [
    {
      "title": "Name",
      "status": "CONFIRMED",
      "payload": {"firstName": "Anna", "lastName": "Schmidt"}
    },
    {
      "title": "Phone",
      "status": "CONFIRMED",
      "payload": {"phoneNumber": "+491701234567"}
    }
  ]
}

自选列表
GET /v1/watchlists opendata
列出浏览自选：多自选屏使用的 id、icon、name 与 subtitle。
认证方式： Authorization: Bearer <sessionToken JWT>，来自登录调用，另带应用版本与平台设备头。
- id
- icon
- name
- subtitle
```
GET /v1/watchlists HTTP/1.1
Authorization: Bearer <sessionToken>
Accept: application/json
```
```
{
  "watchlists": [
    {
      "id": "wl-default",
      "icon": "star",
      "name": "Watchlist",
      "subtitle": "12 instruments"
    }
  ]
}
```

数据类别

会话令牌
现金余额
IBAN 收款地址
时间线交易
组合收益
定投计划
Visa 借记卡
卡片消费限额
德国免税额订单
已实现盈亏
Livret A
现金利息
个人资料
自选列表

数据使用场景与案例

夜间现金与券商对账
资金系统拉取各现金账户的 accountNumber/amount，并与时间线行（title、amount.value、status）对齐，让 Sparplan 成交与 Visa 清算落在同一套欧元账本上。
定投出资监控
家族办公室看板列出定投的 instrumentId、interval、nextExecutionDate，对照 fundingCashAccNo 可用现金，并在下次扣款前标出已暂停计划。
免税额余量
德国税务包装读取免税额订单的 used 对 maximum，以及 realizedPnL.absolute，以便在年底收割前知道剩余 Steuerfreibetrag。
Visa 借记限额盯梢
费用工具订阅 spendDaily/spendMonthly 的 currentSpendWithCurrency 对 limitAmountWithCurrency 以及 lastFourPan 状态，锁卡或 ATM 上限变更当天即可看见。

常见问题

Trade Republic 应用暴露哪些现金与券商数据？

现金账户余额（accountNumber、amount、currency）、SEPA IBAN/BIC 收款地址、时间线交易、Sparplan 定投、Visa 借记卡 lastFourPan 与消费限额、德国 Freistellungsauftrag 的 used 对 maximum、已实现盈亏、Livret A 余额与现金利率。

应用如何鉴权接口调用？

在登录调用中用手机号加 PIN 换取 sessionToken 与 refreshToken JWT。后续调用携带 Authorization: Bearer 以及应用版本与平台设备头。会话续期调用按 subjectId 刷新会话。

覆盖哪些市场？

德国是本土市场；法国与西班牙也已上线（Livret A 与 PEA 税务包装仅法国）。此处展示的端点是对登录后安卓应用背后数据的示意性建模，而非公开开发者计划。

除了余额，能否拿到税务与定投字段？

可以。免税额订单返回 type、amount、used、maximum 与 validUntil；盈亏拆分 realizedPnL 与 dividendReturn；定投列出 instrumentId、interval、nextExecutionDate、paused 与 fundingCashAccNo。

与 Trade Republic: Broker & Bank 相似的应用

Scalable Capital — Scalable Capital 是慕尼黑的数字投资平台兼银行，其 Scalable Broker 可交易股票、ETF、衍生品和加密 ETP，并提供从 1 欧元起投的欧元定投，业务覆盖德国、奥地利、法国、意大利、西班牙和荷兰。
flatex — flatex 是 flatexDEGIRO 集团旗下的德国在线券商，应用和桌面端可在约 40 个交易场所买卖股票、ETF、加密资产、债券和杠杆产品，并提供 5,000 多种 ETF 与基金定投。
DEGIRO — DEGIRO 是总部位于荷兰的在线券商，现为 flatexDEGIRO Bank 的荷兰品牌，让零售投资者接入约 30 个国家的 50 多家交易所。
Revolut — Revolut 是持牌数字银行，应用把活期账户和借记卡与面向欧洲经济区客户的应用内股票、ETF 交易以及英国和欧洲经济区的加密质押放在一起。
N26 — N26 是柏林的直销银行，应用与 Upvest Securities 合作，让符合条件的客户从 1 欧元起买卖股票和 ETF、做定投并购买加密资产，同时使用欧元活期账户。
Trading 212: Stocks, ETFs, ISA — Trading 212 是欧洲券商应用，提供免佣金上市股票和 ETF，以及差价合约、英国现金 ISA 和多币种支付卡，并获德国 BaFin 等监管机构授权。
eToro — eToro 是覆盖股票、ETF、差价合约和加密资产的多资产券商，以 CopyTrader 跟单为核心，欧洲实体受 CySEC 监管，并与德意志交易所合作扩大德国股票供给。

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

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

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

获取报价

Trade Republic 数据 API：端点与字段

应用截图

API 端点一览

PIN 登录

刷新会话

现金账户余额

现金账户 IBAN 明细

时间线交易

组合最新收益

定投计划

当前 Visa 借记卡

卡片消费限额

德国免税额订单

已实现盈亏与分红

Livret A 状态

现金利息首页

客户个人资料

自选列表

数据类别

数据使用场景与案例

夜间现金与券商对账

定投出资监控

免税额余量

Visa 借记限额盯梢

常见问题

与 Trade Republic: Broker & Bank 相似的应用

更多银行类应用

5paisa: Demat, Stocks & IPO

AndroMoney

Angel One: Stocks, Mutual Fund

Bibit- Reksadana & Obligasi

相关主题

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

Trade Republic 数据 API：端点与字段

应用截图

API 端点一览

PIN 登录

刷新会话

现金账户余额

现金账户 IBAN 明细

时间线交易

组合最新收益

定投计划

当前 Visa 借记卡

卡片消费限额

德国免税额订单

已实现盈亏与分红

Livret A 状态

现金利息首页

客户个人资料

自选列表

数据类别

数据使用场景与案例

夜间现金与券商对账

定投出资监控

免税额余量

Visa 借记限额盯梢

常见问题

相关应用

与 Trade Republic: Broker & Bank 相似的应用

更多银行类应用

5paisa: Demat, Stocks & IPO

AndroMoney

Angel One: Stocks, Mutual Fund

Bibit- Reksadana & Obligasi

相关主题

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