创建 Individual 用户并进行 RFQ 询价（Sandbox）
本快速开始将帮助你在 5 分钟内 使用 JSON API 完成 Legend 的最小集成验证。
你将完成以下两个步骤：
- 创建 Individual 用户（进入 KYC 流程）
- 发起法币 RFQ 询价
本文档适用于正在评估或集成 Legend 法币 On-Ramp / Off-Ramp 能力的合作伙伴。
Sandbox Base URL
https://sandboxapi.legendtrading.com
认证方式
所有 API 请求均使用 HTTP Bearer Token 进行认证。
Authorization: Bearer YOUR_SANDBOX_TOKEN必填请求头（Headers）
| Header | 说明 |
|---|---|
Authorization | Legend 提供的 Bearer Token |
Content-Type | application/json |
Accept | application/json |
User-Ip | 最终用户的 IP 地址（用于合规与风控） |
Step 1 — 创建 Individual 用户（KYC）
接口 POST /kyc/individual/pi
接口说明
创建一个 Individual 用户档案，并将该用户纳入 Legend 的 KYC 流程。
⚠️ 重要说明
- 该接口在成功时 不会返回 user_id
- 你在请求中传入的 uid 将作为该用户在 Legend 系统中的唯一标识
- 后续所有与该用户相关的 API 调用（包括 RFQ、交易等）都必须继续使用相同的 uid
请求示例（JSON）
curl --http1.1 -X POST "https://sandboxapi.legendtrading.com/kyc/individual/pi" \
-H "Authorization: Bearer YOUR_SANDBOX_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "User-Ip: 12.34.56.78" \
-d '{
"uid": "demo_user_001",
"email": "[email protected]",
"first_name": "Max",
"middle_name": "Karl",
"last_name": "Mustermann",
"birthdate": "1990-01-15",
"country_iso2_code": "DE",
"state": "BE",
"city": "Berlin",
"address": "Alexanderplatz 1",
"address_line_2": "Room 1001",
"zipcode": "10178",
"citizenship_iso2_codes": "DE",
"place_of_birth": "Berlin",
"phone_isd_code": "49",
"phone_number": "15123456789",
"id_type": "passport",
"id_no": "C01X00ABC12",
"id_doc_type": "passport",
"id_doc_number": "C01X00ABC12",
"ssn": "000-00-0000"
}'
成功响应（200）
{
"request_id": "007fcf2c4dd3d3dd68d6cc0b953bbc95",
"status": "success",
"code": "100000",
"message": "success",
"data": [],
"metadata": {}
}
响应说明
- 表示该用户已成功创建
- 用户已进入 KYC 处理流程
- 不会返回新的用户 ID
- 后续接口请继续使用你提供的 uid（例如：demo_user_001）
Step 2 — 发起 RFQ 询价（法币）
接口 POST /app/rfqbyfiat
接口说明
根据指定金额和交易方向，请求一笔 实时法币 RFQ 报价。
请求示例（JSON）
curl --http1.1 -X POST "https://sandboxapi.legendtrading.com/app/rfqbyfiat" \
-H "Authorization: Bearer YOUR_SANDBOX_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "User-Ip: 12.34.56.78" \
-d '{
"pair": "BTCUSD",
"side": "buy",
"size": "100",
"type": "bank"
}'
成功响应（200）
{
"created": "2023-01-31T16:08:51.913472Z",
"pair": "BTCUSD",
"price": 22596.3949,
"quantity": 0.00433,
"processing_fee": 2,
"network_fee": 0,
"side": "buy",
"size": "100",
}
重要注意事项
关于 uid
- uid 必须在你方系统中保持唯一
- Legend 不会生成额外的 user_id
- 所有后续请求请持续为同一个用户使用同一个 uid
关于 User-Ip
- 生产环境必须传入真实的终端用户 IP
- Sandbox 环境可使用固定值进行测试
- 该字段用于合规与风控判断