> ## Documentation Index > Fetch the complete documentation index at: https://docs.cbpayapp.com/llms.txt > Use this file to discover all available pages before exploring further. # 获取我的外汇汇率与费用 > 返回适用于调用账户的各国汇率——与操作执行时使用的相同(`local_amount / rate = USDT`)——以及账户的**有效**费用配置(组织默认值已与账户覆盖项解析合并),便于客户端在创建操作前计算确切成本。`rate` 为 payout(派发)侧,`payin_rate` 为 payin(充值)侧。`asset_prices` 携带各虚拟余额资产的 USD 参考价(BTC 按单位、GOLD 按克;稳定币约定为 1)用于展示/估值。`settlement` 块按启用的资产显示你的账户此刻从该余额支付操作可获得的**有效结算价格**(`settlement_rate`,已含点差)及该资产当前是否 `available`——可在 payout 传 `settlement_asset` 之前用它来估算。 ## OpenAPI ````yaml /openapi.zh.yaml get /v1/rates openapi: 3.1.0 info: title: CBPay API version: '1.89' description: > CBPay 是一个多币种支付平台:覆盖拉美的法币付款(payout)与收款(payin)、内部转账、链上充值与提现,以及 KYC 筛查。每个账户持有四个相互独立的虚拟余额——USDT(运营货币)、USDC、BTC 和 GOLD(纯金克数)——它们绝不混合也不会自动兑换。 payout 和服务费可从四个余额中的任意一个支付: 用 `PUT /v1/settlement` 设置默认值,或在单笔 payout 中用 `settlement_asset` 覆盖。 所有金额均为十进制字符串,遵循各货币的精度(USDT/USDC/GOLD 为 6 位小数,BTC 为 8 位)。错误始终返回 `{"error": "", "message": ""}`。 servers: - url: https://api.qbank.cl/platform description: Live（生产环境，真实资金） - url: https://cryptobank.qbank.cl/platform description: Test（沙盒，模拟资金 — pk_test_ 密钥） security: - bearerAuth: [] tags: - name: 凭证 description: >- 每笔操作的品牌化 PDF 凭证,附带公开的签名 QR 真伪校验、每个响应/webhook 中的 receipt_url,以及最终状态时的自动邮件发送。 - name: 身份认证 description: 注册与登录账户成员。会话有效期 24 小时。 - name: 账户 description: 调用账户的档案、成员与 API key。 - name: 余额 description: 余额、流水历史与外汇汇率。 - name: 付款(Payouts) description: 从你选择的结算余额扣款的法币派发(默认 USDT)。 - name: 收款(Payins) description: 入账到 USDT 余额的法币充值。 - name: 转账 - name: 联系人 - name: 兑换(Swaps) description: CBPay 账户之间的免费内部转账(个人或企业,任意组合)。 - name: 加密货币 description: 链上充值与提现(TRON、Ethereum 和 Bitcoin)。 - name: 隔离钱包 description: 拥有自身余额的链上钱包(企业不限数量;个人每个网络+资产组合 1 个)——创建、导入、发送、导出私钥与自动转发。余额存在于链上,从不进入账本。 - name: QR Crypto POS description: >- 面向拥有实体 POS 终端的处理商（企业账户）的定额加密货币二维码收款：已验证商户、每笔收款专属地址 + 二维码、支付早期检测、按商户对账，以及经加密货币提现通道的退款。 - name: KYC / KYB - name: AML 筛查 description: 身份验证:个人 KYC、企业 KYB,含 AML 筛查、重新筛查与持续监控。 - name: 钱包筛查 description: 区块链地址的 AML 风险评估(制裁、非法资金暴露),按次收费;另附提现与充值的免费自动防护。 - name: 分析 - name: Webhooks description: 接收签名事件通知的订阅。 - name: 状态 description: 服务可用性。 - name: 银行服务 description: 真实银行账户:通过国际银行通道接收、持有与发送资金。 - name: 卡片 description: 以 Just-In-Time 方式从账户 USDT 余额消费的虚拟卡与实体卡,支持按卡设置消费限额。 - name: 安全(OTP) description: >- 通过 SMS/WhatsApp/email 发送的一次性验证码,保护敏感操作;并提供自助 2FA 偏好设置。仅适用于用户会话——API key 豁免。 - name: 通行密钥 description: >- 通过 WebAuthn 使用设备生物识别(Face ID、Touch ID、Windows Hello、安全密钥)的无密码登录、带备份码的验证器应用(TOTP),以及会话/设备管理。 - name: 社交登录 description: >- 通过令牌交换以 Google、Apple、Microsoft 和 Facebook 实现无密码注册与登录。前端获取提供方凭证;API 验证后签发 CBPay 会话。 paths: /v1/rates: get: tags: - 余额 summary: 获取我的外汇汇率与费用 description: >- 返回适用于调用账户的各国汇率——与操作执行时使用的相同(`local_amount / rate = USDT`)——以及账户的**有效**费用配置(组织默认值已与账户覆盖项解析合并),便于客户端在创建操作前计算确切成本。`rate` 为 payout(派发)侧,`payin_rate` 为 payin(充值)侧。`asset_prices` 携带各虚拟余额资产的 USD 参考价(BTC 按单位、GOLD 按克;稳定币约定为 1)用于展示/估值。`settlement` 块按启用的资产显示你的账户此刻从该余额支付操作可获得的**有效结算价格**(`settlement_rate`,已含点差)及该资产当前是否 `available`——可在 payout 传 `settlement_asset` 之前用它来估算。 operationId: getRates responses: '200': description: 汇率、参考资产价格与费用。 content: application/json: schema: type: object properties: base: type: string example: USD rates: type: object additionalProperties: type: object properties: currency: type: string example: CLP rate: type: string description: 适用于 payout(派发)的汇率。 example: '950.123456' payin_rate: type: string description: 适用于 payin(法币充值/收款)的汇率。 example: '955.10' asset_prices: type: object description: 各虚拟余额资产的 USD 参考价(展示/估值)。 additionalProperties: type: object properties: currency: type: string example: USD unit: type: string description: 价格所指的单位(`btc`、`gram`、`usdt`、`usdc`)。 example: gram price: type: string example: '107.5341' updated_at: type: string description: 此价格最后更新时间。 settlement_grade: type: boolean description: 当价格足够新鲜、可执行结算(从该余额支付的操作)时为 true。 settlement: type: object description: 调用账户的有效结算定价。 properties: default_asset: type: string description: 未传 `settlement_asset` 覆盖时,操作扣款的余额。 example: USDT assets: type: array items: type: object properties: asset: type: string example: BTC available: type: boolean description: 当该资产当前无法使用(已停用或执行价格不可用)时为 false。 settlement_rate: type: string description: 你的余额将按此有效 USD 单价估值(已含点差);不可用时为空。 example: '109029.34' updated_at: type: string fees: type: array items: $ref: '#/components/schemas/FeeConfig' example: base: USD rates: chile: currency: CLP rate: '950.25' payin_rate: '955.10' mexico: currency: MXN rate: '17.50' payin_rate: '17.62' peru: currency: PEN rate: '3.72' payin_rate: '3.75' asset_prices: USDT: currency: USD unit: usdt price: '1' USDC: currency: USD unit: usdc price: '1' BTC: currency: USD unit: btc price: '109853.24' updated_at: '2026-07-07T11:59:41Z' settlement_grade: true GOLD: currency: USD unit: gram price: '107.5341' updated_at: '2026-07-07T09:12:05Z' settlement_grade: true settlement: default_asset: USDT assets: - asset: USDT available: true settlement_rate: '1' - asset: USDC available: true settlement_rate: '0.99900000' - asset: BTC available: true settlement_rate: '109029.34070000' - asset: GOLD available: true settlement_rate: '106.99642950' updated_at: '2026-07-07T12:00:00Z' fees: - id: 3c2b1a09-8d7e-6f5a-4b3c-2d1e0f9a8b7c org_id: 1c9e7a2b-5f6d-4e3a-8c1b-2a9d8e7f6a5b account_id: '' service: payout country: CL asset: USDT percent: '0' fixed_amount: '0.30' status: active updated_at: '2026-07-07T12:00:00Z' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/AccountRequired' '502': description: 外汇汇率暂不可用(`rates_unavailable`)。 content: application/json: schema: $ref: '#/components/schemas/Error' example: error: rates_unavailable message: could not fetch fx rates components: schemas: FeeConfig: type: object properties: id: type: string format: uuid org_id: type: string format: uuid account_id: type: string description: 当费用为 CBPay 默认值(非账户覆盖)时为空。 service: type: string enum: - payout - payin - funding - withdrawal - compliance_person - compliance_company - compliance_rescreen - compliance_transaction - compliance_monitoring country: type: string asset: type: string example: USDT percent: type: string example: '1.5' fixed_amount: type: string example: '0.30' status: type: string example: active updated_at: type: string format: date-time Error: type: object properties: error: type: string description: 机器可读的错误代码(snake_case)。 example: insufficient_funds message: type: string description: 人类可读的说明。 responses: Unauthorized: description: 凭证缺失或无效(`unauthorized`)。 content: application/json: schema: $ref: '#/components/schemas/Error' example: error: unauthorized message: invalid or missing credentials AccountRequired: description: 此端点需要账户凭证(`account_required`)。 content: application/json: schema: $ref: '#/components/schemas/Error' example: error: account_required message: this endpoint requires an account credential securitySchemes: bearerAuth: type: http scheme: bearer description: | 会话 JWT(来自注册/登录)或 API key(`pk_...`)。 也接受 `X-API-Key: ` 作为替代请求头。 ````