{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/zh/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"资金 API 文档"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"资金-api-文档","__idx":0},"children":["资金 API 文档"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["资金接口用于从组织账户向 Infini UID 转账、提现、查询提现状态与手续费，以及查询 USDT、USDC 和 USD 可用余额。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["所有资金接口前缀："]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v2/funds"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"认证与权限","__idx":1},"children":["认证与权限"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["所有接口使用 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HMAC-SHA256"]}," 认证：携带 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Date"]}]},"、有请求体时携带 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Digest"]}]},"，以及带 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["keyId"]}]}," 的 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization"]}]}," 请求头。GET 请求带查询参数时，签名路径必须包含完整 query string。计算方式见 ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/zh/docs/en/4-authorization"},"children":["章节 4：授权与安全机制"]},"。"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"权限"},"children":["权限"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"适用接口"},"children":["适用接口"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fund.withdraw"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v2/funds/internal-transfer"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v2/funds/withdraw"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v2/funds/withdraw/status"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v2/funds/withdraw/status/batch"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v2/funds/withdraw/fees"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v2/funds/balances"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["IP 白名单："]}," 包含 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fund.withdraw"]}," 权限的 API Key，必须在商户后台创建或更新时配置非空的 IP 白名单。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"提现幂等","__idx":2},"children":["提现幂等"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["创建提现时，",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["request_id"]}," 为可选字段："]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["不传时，由 Infini 生成提现请求 ID，并保持原有提现逻辑。调用方重试时如果没有复用同一个 ID，则不具备幂等保障。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["传入时必须为 UUID，并作为本次提现的幂等键。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["同一商户使用相同 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["request_id"]}," 重试时，接口会返回之前创建的提现订单信息，并设置 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_duplicate: true"]},"。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["一个 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["request_id"]}," 只能用于一笔逻辑提现。请勿将其复用于不同金额、链、代币或目标地址。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"响应信封","__idx":3},"children":["响应信封"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["通过网关鉴权后，应用层响应统一使用 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["code"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["message"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data"]}," 信封。",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["code === 0"]}," 表示业务成功，非零 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["code"]}," 表示错误，详情见 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["message"]},"。部分下游业务错误可能以 HTTP 200 返回，此时 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["code"]}," 非零且 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data"]}," 为 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},"。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["HMAC 或网关校验失败时，请求可能在到达应用前被拒绝，并返回类似 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{\"message\":\"client request can't be validated\"}"]}," 的网关响应，而不是应用层信封。客户端应先检查 HTTP 状态，再在存在信封时检查 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["code"]},"。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"向-infini-uid-转账","__idx":4},"children":["向 Infini UID 转账"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["POST"]}," /v2/funds/internal-transfer"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["从当前认证组织向 Infini UID 对应的收款方转账。"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["所需权限："]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fund.withdraw"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["V1 仅支持 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USDT"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USDC"]}," 或 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USD"]}," 同币种转账。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["内部转账不收取手续费：发送方扣款金额等于收款方到账金额。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["V1 成功时会同步完成账本转账，并返回 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status: completed"]},"。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"request-body","__idx":5},"children":["Request Body"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"字段"},"children":["字段"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"类型"},"children":["类型"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"必填"},"children":["必填"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"说明"},"children":["说明"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["request_id"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (UUID)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["否"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["幂等键。不传时由 Infini 生成"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["recipient_uid"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["是"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["收款方 Infini UID；不能属于转出组织自身"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["token_type"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["是"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["收款账户币种：",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USDT"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USDC"]}," 或 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USD"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["source_currency"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["否"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["扣款账户币种；不传时默认等于 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["token_type"]},"。V1 要求与 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["token_type"]}," 相同"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["amount"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["是"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["扣款和到账金额，必须为正数。",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USDT"]}," 和 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USDC"]}," 最多支持六位小数，最小为 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0.000001"]},"；",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USD"]}," 最多支持两位小数，最小为 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0.01"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["note"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["否"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["可选转账备注"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"请求示例","__idx":6},"children":["请求示例"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"request_id\": \"4b4436ba-90a1-4f26-940d-97177a7a3400\",\n  \"recipient_uid\": \"12345678\",\n  \"token_type\": \"USDC\",\n  \"source_currency\": \"USDC\",\n  \"amount\": \"10.25\",\n  \"note\": \"Customer refund\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"响应示例","__idx":7},"children":["响应示例"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"code\": 0,\n  \"message\": \"\",\n  \"data\": {\n    \"request_id\": \"4b4436ba-90a1-4f26-940d-97177a7a3400\",\n    \"status\": \"completed\",\n    \"is_duplicate\": false\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["request_id"]}," 为可选字段。传入时必须为 UUID，并作为幂等键。同一组织使用已经完成的 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["request_id"]}," 重试时，会返回原请求 ID，并设置 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_duplicate: true"]},"。一个请求 ID 只能用于一笔逻辑转账，请勿将其复用于不同转账信息。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"错误码","__idx":8},"children":["错误码"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"HTTP 状态码"},"children":["HTTP 状态码"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Code"},"children":["Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"说明"},"children":["说明"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["401"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["401"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["应用层无法认证 API Key"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["403"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["403"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["API Key 缺少 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fund.withdraw"]}," 权限，或 IP 白名单校验未通过"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400 或 200"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["30013"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["请求参数无效，包括 UUID、UID、币种、金额、精度、跨币种转账、向自身转账，或请求 ID 已属于其他组织"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["200"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["10005"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["找不到发送方或收款方"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["200"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["10030"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["转出组织的 Owner 处于转账保护状态"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["200"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["20012"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["扣款账户的可用余额不足"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["200"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["30005"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["转账金额超过剩余操作限额"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["200"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["30015"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["转出组织被限制内部转账"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["200"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["30034"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["扣款币种为 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USD"]},"，但组织未开通 USD Cash Account"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["500"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["500"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["发生未预期的内部错误或下游服务错误"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"提取组织资金","__idx":9},"children":["提取组织资金"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["POST"]}," /v2/funds/withdraw"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["从当前认证组织账户向外部钱包发起提现。"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["所需权限："]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fund.withdraw"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"request-body-1","__idx":10},"children":["Request Body"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"字段"},"children":["字段"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"类型"},"children":["类型"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"必填"},"children":["必填"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"说明"},"children":["说明"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["request_id"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (UUID)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["否"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["幂等键。不传时由 Infini 生成"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["chain"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["是"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["公网链名称，例如 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ETHEREUM"]}," 或 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ARBITRUM"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["token_type"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["是"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["代币类型，例如 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USDT"]}," 或 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USDC"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["source_currency"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["否"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["扣款账户币种；不传时默认等于 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["token_type"]},"。提取 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USDT"]}," 或 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USDC"]}," 时可设为 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USD"]},"，从组织的 USD Cash Account 扣款；不支持其他跨币种组合"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["amount"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["是"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["从扣款账户最多扣除的金额；第六位小数后的数字会直接截断而非四舍五入；",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["source_currency"]}," 为 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USD"]}," 时最多支持两位小数。截断后金额必须至少为 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]}," 且大于相关费用"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["wallet_address"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["是"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["与所选链匹配的目标钱包地址"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["note"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["否"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["可选的提现备注"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["请以 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v2/funds/withdraw/fees"]}]}," 返回的当前可用链/代币组合和手续费为准。示例中的链和代币名称均使用大写。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"请求示例-1","__idx":11},"children":["请求示例"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"request_id\": \"e94b4e88-36c2-4550-907e-839742cf5fae\",\n  \"chain\": \"ETHEREUM\",\n  \"token_type\": \"USDT\",\n  \"source_currency\": \"USD\",\n  \"amount\": \"10.00\",\n  \"wallet_address\": \"0x5f716e5775b18409917e2a2f0762d29d6c385cb0\",\n  \"note\": \"Treasury withdrawal\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"响应示例-1","__idx":12},"children":["响应示例"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"code\": 0,\n  \"message\": \"\",\n  \"data\": {\n    \"request_id\": \"e94b4e88-36c2-4550-907e-839742cf5fae\",\n    \"status\": \"pending\",\n    \"is_duplicate\": false\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["幂等重试时，",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.is_duplicate"]}," 为 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},"，",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.status"]}," 为已有提现单的当前状态。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"错误码-1","__idx":13},"children":["错误码"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"HTTP 状态码"},"children":["HTTP 状态码"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Code"},"children":["Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"说明"},"children":["说明"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["401"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["401"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["应用层无法认证 API Key"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["403"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["403"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["API Key 缺少 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fund.withdraw"]}," 权限、IP 白名单校验未通过，或所选链/代币组合未启用提现"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["200"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["30001"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["核心提现配置拒绝了所选代币"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["200"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["30002"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["组织的扣款资金账户不存在"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["200"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["30003"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["扣款账户的可用余额不足"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["200"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["30005"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["提现金额超过当日剩余限额"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["200"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["30007"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["提现金额低于最低要求，或金额不大于相关手续费"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["200"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["30012"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["所选链/代币组合没有可用的提现手续费配置"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400 或 200"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["30013"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["请求参数无效，例如 UUID、链/代币组合、金额、精度、扣款币种或钱包地址无效"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["200"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["30022"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["目标地址是 Infini 内部地址；请改用内部转账"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["200"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["30023"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["扣除锁定或预留资金后，可用余额不足"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["200"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["30034"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["source_currency"]}," 为 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USD"]},"，但组织未开通 USD Cash Account"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["200"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["80016"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["暂时无法获取所需的资产价格或汇率"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["500"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["500"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["发生未预期的内部错误或下游服务错误"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["核心资金服务返回的错误使用标准应用层信封；即使 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["code"]}," 非零，HTTP 状态也可能是 200。由网关直接拒绝的 HMAC 校验错误可能不包含应用层错误码。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"查询提现状态","__idx":14},"children":["查询提现状态"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["GET"]}," /v2/funds/withdraw/status?request_id={request_id}"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["查询当前认证组织名下提现单的状态和金额信息。"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["所需权限："]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fund.withdraw"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["HMAC 签名路径必须包含 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["?request_id={request_id}"]},"。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"请求参数","__idx":15},"children":["请求参数"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"字段"},"children":["字段"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"类型"},"children":["类型"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"必填"},"children":["必填"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"说明"},"children":["说明"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["request_id"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (UUID)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["是"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["提现请求 ID"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"响应示例-2","__idx":16},"children":["响应示例"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"code\": 0,\n  \"message\": \"\",\n  \"data\": {\n    \"request_id\": \"e94b4e88-36c2-4550-907e-839742cf5fae\",\n    \"status\": \"completed\",\n    \"amount\": \"11\",\n    \"fee\": \"0.1\",\n    \"actual_amount\": \"10.9\",\n    \"transaction_hash\": \"0xabc123\",\n    \"chain\": \"ETHEREUM\",\n    \"token_type\": \"USDT\",\n    \"source_currency\": \"USD\",\n    \"gas_fee\": \"0.08\",\n    \"gas_fee_currency\": \"USD\",\n    \"fx_fee\": \"0.02\",\n    \"fx_fee_currency\": \"USD\",\n    \"fee_paid_by\": \"BENEFICIARY\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"响应字段","__idx":17},"children":["响应字段"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"字段"},"children":["字段"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"类型"},"children":["类型"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"说明"},"children":["说明"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["request_id"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["提现请求 ID"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["status"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["当前提现状态"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["amount"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["从扣款账户扣除的总金额"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["fee"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["兼容保留的 Gas 费字段；新接入请使用 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gas_fee"]}," 和 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gas_fee_currency"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["actual_amount"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["以 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["token_type"]}," 计价的实际上链金额"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["transaction_hash"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["链上交易哈希；尚未提交时为空字符串"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["chain"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["公网链名称"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["token_type"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["代币类型"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["source_currency"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["扣款账户币种"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["gas_fee"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["本次提现向用户收取的 Gas 费"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["gas_fee_currency"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gas_fee"]}," 的币种"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["fx_fee"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["跨币种提现的换汇手续费；同币种提现为 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["fx_fee_currency"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fx_fee"]}," 的币种"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["fee_paid_by"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["费用承担方：",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAYER"]}," 或 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BENEFICIARY"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"状态说明","__idx":18},"children":["状态说明"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"状态"},"children":["状态"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"说明"},"children":["说明"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pending"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["提现已创建，等待提交或审核"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["processing"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["交易已提交，等待确认"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["completed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["提现已完成"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["提现失败"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"分页查询提现状态","__idx":19},"children":["分页查询提现状态"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["POST"]}," /v2/funds/withdraw/status/batch"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["按创建时间范围分页查询当前认证组织名下的提现状态。"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["所需权限："]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fund.withdraw"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["start_time"]}," 和 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["end_time"]}," 使用 Unix 秒级时间戳，并构成闭区间。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["返回结果按 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["created_at"]}," 降序排列。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["page"]}," 默认为 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]},"；",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["page_size"]}," 默认为 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["20"]},"，最大为 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["100"]},"。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["时间范围内没有匹配提现时仍返回 HTTP 200，且 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["withdrawals"]}," 为空数组。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["时间范围或分页参数无效时返回 HTTP 400；无法完成整个查询的内部或下游错误返回 HTTP 500。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"request-body-2","__idx":20},"children":["Request Body"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"字段"},"children":["字段"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"类型"},"children":["类型"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"必填"},"children":["必填"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"说明"},"children":["说明"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["start_time"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["整数"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["是"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["提现创建时间的起始值，Unix 秒级时间戳，包含该时间点"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["end_time"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["整数"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["是"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["提现创建时间的结束值，Unix 秒级时间戳，包含该时间点；必须大于等于 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["start_time"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["page"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["整数"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["否"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["页码，默认为 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["page_size"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["整数"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["否"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["每页提现数量，默认为 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["20"]},"，最大为 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["100"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"请求示例-2","__idx":21},"children":["请求示例"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"start_time\": 1787500000,\n  \"end_time\": 1787599999,\n  \"page\": 1,\n  \"page_size\": 20\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["本接口为带请求体的 POST 请求，HMAC 请求需携带请求体 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Digest"]},"，并签名路径 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v2/funds/withdraw/status/batch"]},"。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"响应示例-3","__idx":22},"children":["响应示例"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"code\": 0,\n  \"message\": \"\",\n  \"data\": {\n    \"withdrawals\": [\n      {\n        \"request_id\": \"e94b4e88-36c2-4550-907e-839742cf5fae\",\n        \"created_at\": 1787564636,\n        \"status\": \"completed\",\n        \"amount\": \"11\",\n        \"fee\": \"0.1\",\n        \"actual_amount\": \"10.9\",\n        \"transaction_hash\": \"0xabc123\",\n        \"chain\": \"ETHEREUM\",\n        \"token_type\": \"USDT\",\n        \"source_currency\": \"USDT\",\n        \"gas_fee\": \"0.1\",\n        \"gas_fee_currency\": \"USDT\",\n        \"fx_fee\": \"0\",\n        \"fx_fee_currency\": \"USDT\",\n        \"fee_paid_by\": \"BENEFICIARY\"\n      }\n    ],\n    \"total\": 1,\n    \"page\": 1,\n    \"page_size\": 20,\n    \"total_pages\": 1\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["每个条目的金额、费用、链和状态语义与单笔查询一致，并额外返回 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["created_at"]},"。分页信息描述时间范围内的完整匹配结果，而不仅是当前页。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"查询提现手续费","__idx":23},"children":["查询提现手续费"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["GET"]}," /v2/funds/withdraw/fees"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["返回当前已启用的公网链/代币组合及其手续费。手续费是动态配置，客户端应调用本接口，不要硬编码手续费表。"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["所需权限："]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fund.withdraw"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"响应示例-4","__idx":24},"children":["响应示例"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"code\": 0,\n  \"message\": \"\",\n  \"data\": {\n    \"fees\": [\n      {\n        \"chain\": \"ARBITRUM\",\n        \"token_type\": \"USDC\",\n        \"withdraw_fee\": \"0.5\"\n      },\n      {\n        \"chain\": \"ETHEREUM\",\n        \"token_type\": \"USDT\",\n        \"withdraw_fee\": \"2\"\n      }\n    ]\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["每个 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["withdraw_fee"]}," 都使用对应的 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["token_type"]}," 计价。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"查询可用余额","__idx":25},"children":["查询可用余额"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["GET"]}," /v2/funds/balances"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["仅返回当前认证组织的 USDT、USDC 和 USD Cash ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AVAILABLE_BALANCE"]},"。"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["所需权限："]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fund.withdraw"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"响应示例-5","__idx":26},"children":["响应示例"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"code\": 0,\n  \"message\": \"\",\n  \"data\": {\n    \"available_balance_usdt\": \"120.50\",\n    \"available_balance_usdc\": \"75.25\",\n    \"available_balance_usd\": \"1000.00\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["如果组织没有某个币种的余额记录，对应值返回 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"0\""]},"。其中，USD Cash Account 未开通时，",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["available_balance_usd"]}," 返回 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"0\""]},"。"]}]},"headings":[{"value":"资金 API 文档","id":"资金-api-文档","depth":2},{"value":"认证与权限","id":"认证与权限","depth":3},{"value":"提现幂等","id":"提现幂等","depth":3},{"value":"响应信封","id":"响应信封","depth":3},{"value":"向 Infini UID 转账","id":"向-infini-uid-转账","depth":3},{"value":"Request Body","id":"request-body","depth":4},{"value":"请求示例","id":"请求示例","depth":4},{"value":"响应示例","id":"响应示例","depth":4},{"value":"错误码","id":"错误码","depth":4},{"value":"提取组织资金","id":"提取组织资金","depth":3},{"value":"Request Body","id":"request-body-1","depth":4},{"value":"请求示例","id":"请求示例-1","depth":4},{"value":"响应示例","id":"响应示例-1","depth":4},{"value":"错误码","id":"错误码-1","depth":4},{"value":"查询提现状态","id":"查询提现状态","depth":3},{"value":"请求参数","id":"请求参数","depth":4},{"value":"响应示例","id":"响应示例-2","depth":4},{"value":"响应字段","id":"响应字段","depth":4},{"value":"状态说明","id":"状态说明","depth":4},{"value":"分页查询提现状态","id":"分页查询提现状态","depth":3},{"value":"Request Body","id":"request-body-2","depth":4},{"value":"请求示例","id":"请求示例-2","depth":4},{"value":"响应示例","id":"响应示例-3","depth":4},{"value":"查询提现手续费","id":"查询提现手续费","depth":3},{"value":"响应示例","id":"响应示例-4","depth":4},{"value":"查询可用余额","id":"查询可用余额","depth":3},{"value":"响应示例","id":"响应示例-5","depth":4}],"frontmatter":{"seo":{"title":"资金 API 文档"}},"lastModified":"2026-08-28T10:50:44.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/zh/docs/en/fund-api","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}