宇海开放 API，一键对接。

开始之前

1. 在 登录 / 充值 注册账户并充值 USDT 余额。
2. 在账户页面底部「API 对接」新建 API Key（只显示一次，请妥善保存）。
3. 请求时带上请求头：Authorization: Bearer yhk_你的密钥，POST 请求使用 Content-Type: application/json。
4. 频率限制：每个 Key 每分钟 120 次。出错时返回 { "error": "说明" } 和对应 HTTP 状态码。

curl -s https://yhcc.io/api/v1/account \
  -H "Authorization: Bearer yhk_xxxxxxxx"

curl -s -X POST https://yhcc.io/api/v1/vanity/orders \
  -H "Authorization: Bearer yhk_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"qty":10,"filter":{"spec":"repeat|tail|5"},"client":"order-0001"}'

库存目录与价格表

返回每个规格（类型 + 位置 + 位数）的在售数量，以及 1 个 / 10 个起 / 100 个起的单价。

返回示例

{
  "total": 1288,
  "byCategory": { "repeat": 120, "sequence": 96, ... },
  "specs": [
    { "spec": "repeat|tail|6", "name": "尾号豹子号 · 6 位", "stock": 12,
      "price1": "80.000000", "price10": "72.000000", "price100": "64.000000" }
  ]
}

查询在售靓号

筛选参数：category（repeat 豹子 / sequence 顺子 / pairs 对子 / double 叠号 / lucky 吉利数 / word 英文单词），pos（tail 尾号 / head 开头 / mid 中间），len、lenMin、lenMax，cls（digit / upper / lower / mixed），q（包含的号码），ending（地址结尾），spec，priceMin、priceMax（USDT），sort（score / price_asc / price_desc / len_desc / new），page、pageSize（最多 100）。

返回示例

{
  "items": [
    { "id": "VI_...", "address": "T...888888", "category": "repeat", "pos": "tail",
      "len": 6, "text": "888888", "spec": "repeat|tail|6", "price": "80.000000" }
  ],
  "total": 12, "page": 1, "pageSize": 50
}

报价（不下单）

按指定 id 或按规格 + 数量询价，返回实际应付金额（自动套用 10 个起 / 100 个起批量价）。

请求示例

{ "qty": 20, "filter": { "spec": "repeat|tail|5" } }
// 或 { "ids": ["VI_aaa", "VI_bbb"] }

返回示例

{ "qty": 20, "tier": 10, "total": "360.000000", "listTotal": "400.000000", "saved": "40.000000", "items": [...] }

下单（默认余额支付，立即发货）

从账户余额扣款，成功后订单状态为 paid，可立刻取回私钥。client 为你自己的请求编号（8~64 位字母数字），重复提交同一个 client 不会重复扣款。也可传 "funding": "transfer" 生成链上付款订单（需按返回的 amount 精确转账 USDT）。单次最多 500 个。

请求示例

{ "qty": 20, "filter": { "spec": "repeat|tail|5" }, "client": "my-order-0001" }
// 或 { "ids": ["VI_aaa", "VI_bbb"], "client": "my-order-0002" }

返回示例

{ "id": "VB_...", "status": "paid", "qty": 20, "total": "360.000000", "items": [ { "address": "T...", "price": "18.000000" } ] }

取回订单与私钥

订单已付款时，返回每个地址的私钥（64 位十六进制）。每次读取都会记录审计日志。

返回示例

{ "id": "VB_...", "status": "paid", "items": [ { "address": "T...", "specName": "尾号豹子号 · 5 位", "price": "18.000000", "privateKey": "…64 hex…" } ] }

订单列表

最近 50 个订单（不含私钥）。

返回示例

{ "items": [ { "id": "VB_...", "status": "paid", "qty": 20, "total": "360.000000", ... } ] }

账户余额

查询 API Key 所属账户的 USDT 余额。余额请在网站「登录 / 充值」页面充值。

返回示例

{ "id": "CU_...", "username": "agent01", "balance": "1200.000000" }

规格编码

spec = 类型|位置|位数，例如 repeat|tail|6 表示尾号 6 位豹子号，word|head|4 表示开头 4 个字母的英文单词。

能量租赁、TRX 闪兑、Telegram 会员等其他业务的 API 会陆续开放到同一套 Key 下。