TP钱包API接口接入全流程：开发者实操避坑指南

TP钱包开放了RESTful API，覆盖链上转账、交易查询、NFT管理及多链桥接。对需要把钱包功能嵌入自有产品的开发者而言，理清接口调用链路是落地的关键。

申请与鉴权：注册后在控制台生成API Key和Secret，每次请求Header携带Bearer token（OAuth2.0客户端凭证模式TP钱包的API接口使用说明，有效期两小时）。建议服务端缓存token并自动刷新，避免高频获取触发限流。

核心交易接口：/v1/transfer执行链上转账，参数含目标地址、最小单位金额及gas。/v1/tx/query按哈希或地址分页查历史。NFT操作走/v1/nft，兼容ERC-721与ERC-1155。

TP钱包RESTful API接口调用指南_TP钱包API鉴权与限流配置_TP钱包的API接口使用说明

事件回调：支持Webhook订阅，交易确认、余额变动、合约事件触发时向指定URL推送JSON。接收端必须校验X-TP-Signature签名头，防止伪造回调污染数据。

限流与错误：QPS上限60次/秒，超限返回429。统一用code字段标识状态，0为成功。生产环境建议配指数退避重试队列，5xx错误自动重发。

联调阶段切至Sandbox环境TP钱包API接口接入全流程：开发者实操避坑指南，不消耗真实gas，接口路径与鉴权流程同生产一致。测试通过后将Base URL替换为生产域名即可上线。