借入

POST/api/v1/px/borrowBearer

PX 发现与账户一律 E6 十进制字符串A | B

计入债务并持续计息，现金入账。同步执行，成功直接返回最新信用状态—— 没有 202 语义，也没有 cursor。

失败是 400 + {code, message}，不是统一错误体 {error, message, recoverable}。code ∈ INVALID_AMOUNT / EXCEEDS_MAX_BORROW。辖区准入不通过同样在此拦下。

请求头 Authorization: Bearer <token>。token 由 POST /api/v1/auth/verify 签发，24h 空闲或签发满 7d 后失效。

请求体

amountE6string必填
金额，E6 字符串；必须为正数

响应

200借入成功，返回最新信用状态

debtE6string
含息债务，E6 字符串
equityE6string
账户净值，E6 字符串
grossE6string
总敞口，E6 字符串
healthBpsstring可为空
健康度，基点。无债务时为 null（健康度无定义），不要当 0
healthyboolean
是否在维持线之上；无债务时为 true
示例false
borrowAprBpsstring
借入年化利率，基点
maxBorrowE6string
当前可借上限，E6 字符串
lendDepositE6string
已出借本金，E6 字符串
maintenanceBpsstring
维持保证金率，基点；healthBps 低于它触发强平
initialMarginBpsstring
初始保证金率，基点

在响应示例中切换状态码查看错误响应，完整错误码见错误码页。

请求

curl -X POST "$BASE_URL/api/v1/px/borrow" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "amountE6": "1000000000"
  }'

响应

借入成功，返回最新信用状态

{
  "debtE6": "<debtE6>",
  "equityE6": "<equityE6>",
  "grossE6": "<grossE6>",
  "healthBps": null,
  "healthy": false,
  "borrowAprBps": "<borrowAprBps>",
  "maxBorrowE6": "<maxBorrowE6>",
  "lendDepositE6": "<lendDepositE6>",
  "maintenanceBps": "<maintenanceBps>",
  "initialMarginBps": "<initialMarginBps>"
}

请求体

amountE6string必填
金额，E6 字符串；必须为正数

响应

200借入成功，返回最新信用状态

debtE6string
含息债务，E6 字符串
equityE6string
账户净值，E6 字符串
grossE6string
总敞口，E6 字符串
healthBpsstring可为空
健康度，基点。无债务时为 null（健康度无定义），不要当 0
healthyboolean
是否在维持线之上；无债务时为 true
示例false
borrowAprBpsstring
借入年化利率，基点
maxBorrowE6string
当前可借上限，E6 字符串
lendDepositE6string
已出借本金，E6 字符串
maintenanceBpsstring
维持保证金率，基点；healthBps 低于它触发强平
initialMarginBpsstring
初始保证金率，基点

在响应示例中切换状态码查看错误响应，完整错误码见错误码页。