公共接口（明文，免加密/签名）

平台提供 4 个公共工具接口，基址 https://api.anonypay.io/api/common/，用于查询币种费率、校验地址与链上交易、生成收款地址二维码。

请勿对这些接口套用 v2 加密流程

与业务接口（/api/merchant/*）不同，本页接口不加密、不签名、不需要 token，请求参数与响应均为明文（二维码接口直接返回 PNG 图片）。不要对它们套用 v2 的加密/签名/防重放流程，也无需先调用 getToken。

接口一览

接口	方法与路径	说明
getCurrencies	`POST /api/common/getCurrencies`	货币与费率列表
isAddress	`POST /api/common/isAddress`	校验地址合法性
checkTransfer	`POST /api/common/checkTransfer`	校验链上转账交易
generateAddresssQrCode	`GET /api/common/generateAddresssQrCode`	生成地址二维码（返回 PNG）

前三个接口的响应为明文 JSON：{ "code": ..., "data": ..., "message": ... }。code == 10000 表示成功；9999 表示失败，message 为原因。无需验签、无需解密，直接解析即可。

货币与费率列表 — getCurrencies

POST https://api.anonypay.io/api/common/getCurrencies

请求参数：无。

bash

curl -X POST https://api.anonypay.io/api/common/getCurrencies

响应：data 为货币数组，每个元素字段：

字段	说明
`name`	货币名称
`symbol`	货币符号（如 `trx.usdt`）
`deposit_fixed_fee` / `deposit_percent_fee`	充值固定费 / 百分比费
`withdraw_fixed_fee` / `withdraw_percent_fee`	提现固定费 / 百分比费
`deposit_min_fee` / `deposit_max_fee`	充值手续费下限 / 上限
`withdraw_min_fee` / `withdraw_max_fee`	提现手续费下限 / 上限
`deposit_min` / `withdraw_min`	最低充值额 / 最低提现额

平台对外支持的币种符号以接口参考总览的枚举为准（13 种）。创建提现单前，建议先用本接口获取各币种的 withdraw_min 与费率，在商户侧提前校验，减少 withdrawMinAmount / invalidAmount 报错。

TRON-USDC 充值已关闭

平台不支持 TRON 链 USDC（trx.usdc）充值：向平台生成的 TRON（trx）收款地址转入 USDC，到账不入账、不会触发回调，资金无法自动到达商户余额。对外币种枚举（13 种）中不包含 trx.usdc，请勿引导用户在 TRON 链充值 USDC；ETH / Solana / BNB 链上的 USDC 不受影响。

校验地址合法性 — isAddress

POST https://api.anonypay.io/api/common/isAddress

校验一个地址在指定币种对应链上是否合法。建议在调用创建提现单之前先校验用户提交的提现地址，把明显非法的地址挡在商户侧。

请求参数

字段	类型	必填	说明
`address`	string	是	待校验地址
`coin_type`	string	是	货币符号（如 `trx`、`eth.usdt`）

bash

curl -X POST https://api.anonypay.io/api/common/isAddress \
  --data-urlencode "address=TXYZ...你的地址..." \
  --data-urlencode "coin_type=trx"

响应：code == 10000 表示地址合法；9999 表示地址非法或币种不存在（coin_type 拼写错误也会落在这个分支，注意与真正的非法地址区分）。

校验转账交易 — checkTransfer

POST https://api.anonypay.io/api/common/checkTransfer

按交易哈希校验一笔链上转账是否有效。

请求参数

字段	类型	必填	说明
`txid`	string	是	链上交易哈希
`coin_type`	string	是	货币符号

bash

curl -X POST https://api.anonypay.io/api/common/checkTransfer \
  --data-urlencode "txid=d5b2...链上交易哈希...c91a" \
  --data-urlencode "coin_type=trx.usdt"

响应：code == 10000 表示交易有效；9999 表示无效（message 为原因）。

实现细节：频率限制

同一个 txid 有 5 秒查询冷却，冷却期内重复查询不会返回新结果。
接口整体限流 20 次/分钟，超出会被直接拒绝。

请不要用本接口做高频轮询确认到账——充值到账请以平台的充值到账回调为准，本接口仅用于人工核查或低频校验。

生成地址二维码 — generateAddresssQrCode

GET https://api.anonypay.io/api/common/generateAddresssQrCode

按地址生成收款二维码图片。这是本组接口中唯一的 GET 接口，且响应不是 JSON，而是直接返回 PNG 图片（Content-Type: image/png），可在页面中直接用 <img src> 引用。

接口名拼写

路径中的 generateAddresssQrCode 里 Addresss 是三个连续的 s（历史拼写），请照抄，不要"纠正"成两个 s，否则 404。

请求参数（query string）

字段	类型	必填	说明
`address`	string	是	地址，仅允许 `A-Za-z0-9`、`-`、`_`、`.`、`+` 字符
`address_type`	string	是	`trx` `solana` `eth_bnb` `ton` `eth` `bnb` 之一；`btc` 为 Bitcoin 预留值，正式开放前不要使用

curlHTML 直接引用

bash

curl -G "https://api.anonypay.io/api/common/generateAddresssQrCode" \
  --data-urlencode "address=TXYZ...你的地址..." \
  --data-urlencode "address_type=trx" \
  -o qrcode.png

html

<img
  src="https://api.anonypay.io/api/common/generateAddresssQrCode?address=TXYZ...你的地址...&address_type=trx"
  alt="收款地址二维码"
/>

响应：PNG 图片二进制（Content-Type: image/png），非 JSON；参数不合法时不会生成图片。

实现细节：参数校验

address 在服务端按正则 ^[A-Za-z0-9\-\_\.\+]+$ 整串校验，含空格或其他字符会被直接拒绝。
address_type 在当前业务接口开放的 addressType（trx/solana/eth_bnb/ton）之外，额外接受 eth、bnb 两个值；btc 为预留值，Bitcoin 正式开放前不要使用。

公共接口（明文，免加密/签名） ​

接口一览 ​

货币与费率列表 — getCurrencies ​

校验地址合法性 — isAddress ​

校验转账交易 — checkTransfer ​

生成地址二维码 — generateAddresssQrCode ​

相关页面 ​

公共接口（明文，免加密/签名）

接口一览

货币与费率列表 — getCurrencies

校验地址合法性 — isAddress

校验转账交易 — checkTransfer

生成地址二维码 — generateAddresssQrCode

相关页面