快速开始

1. 拿到凭证

开通商户后，平台会提供：

凭证	用途
API key + API secret	调用接口时签名。secret 只显示一次，请妥善保存；可按权限范围（read / deposit / withdraw）分别创建，并绑定 IP 白名单
回调地址 + 回调密钥	我们向你的地址推送事件时，用回调密钥签名，你用它验签

Base URL：https://api.dtpg.net

2. 发第一个请求

查询支持的链。每个请求都要带 4 个签名请求头，规则见 签名认证；各语言的现成代码见 多语言示例。

# 1. 你的凭证
API_KEY="你的 API key"
API_SECRET="你的 API secret"

# 2. 本次请求
METHOD="GET"
URI_PATH="/v1/chains"
QUERY=""                                # 查询串（规范化后的），没有就留空
BODY=""                                 # 请求体，GET 留空
TIMESTAMP=$(( $(date +%s) * 1000 ))     # 当前时间，Unix 毫秒
NONCE=$(openssl rand -hex 16)           # 32 位随机串

# 3. 待签名串：6 段用换行连接
BODY_HASH=$(printf '%s' "$BODY" | openssl dgst -sha256 | awk '{print $NF}')
STRING_TO_SIGN=$(printf '%s\n%s\n%s\n%s\n%s\n%s' \
  "$METHOD" "$URI_PATH" "$QUERY" "$TIMESTAMP" "$NONCE" "$BODY_HASH")

# 4. 签名 = HMAC-SHA256(API secret, 待签名串)，hex
SIGNATURE=$(printf '%s' "$STRING_TO_SIGN" | openssl dgst -sha256 -hmac "$API_SECRET" | awk '{print $NF}')

# 5. 发请求
curl "https://api.dtpg.net${URI_PATH}" \
  -H "X-Api-Key: $API_KEY" \
  -H "X-Timestamp: $TIMESTAMP" \
  -H "X-Nonce: $NONCE" \
  -H "X-Signature: $SIGNATURE"

{ "chains": [{ "code": "TRON", "name": "TRON" }] }

3. 典型接入流程

1. 给用户分配充值地址：POST /v1/wallets/{user_id}/addresses（幂等，可以每次展示前调用）。
2. 等待充值回调 deposit.confirmed：按 event_id 去重后给用户加余额。漏收时用 GET /v1/events 补拉。
3. 发起提现：POST /v1/withdraws，biz_id 用你自己的订单号（幂等键）。
4. 跟踪提现：回调 withdraw.broadcasted → withdraw.confirmed（或 withdraw.failed / withdraw.rejected），也可 GET /v1/withdraws/{withdraw_id} 主动查。

给 AI / 代码助手

把 /llms-full.txt 或 /openapi.yaml 交给你的 AI 助手，它就能按本文档生成接入代码。每页标题下也有「复制为 Markdown」按钮。