Binance JavaScript 钱包连接器
这是Binance钱包 API的客户端库,使开发者能够与Binance的钱包交易平台进行程序互动. 该库通过 REST API 提供工具,用于与相钱包相关的功能交互,如灰尘转换/查询平衡等:
目录
支持的特性
- REST API 结束点 :
/sapi/v1/account/*/sapi/v1/accountSnapshot/*/sapi/v1/asset/*/sapi/v3/asset/*/sapi/v1/capital/*/sapi/v1/spot/*/sapi/v1/system/*/sapi/v1/localentity/*/sapi/v2/localentity/*
- 包括测试案例和快速上船的例子.
安装
要使用此库, 请确保您的环境正在运行节点. js 版本 22.12.0 国家 或后会. 如果你在用的话 nvm (节点版本管理器),您可以设置正确的版本如下:
nvm install 22.12.0
nvm use 22.12.0
然后使用 npm数字 :
npm install @binance/wallet
文档
关于详细情况,请参看 Binance API 文档。 。 。 .
REST APIs 软件
所有 REST API 端点都可通过 rest-api 模块。 注意一些端点需要使用您的 Binance API 证书进行认证 .
import { Wallet, WalletRestAPI } from '@binance/wallet';
const configurationRestAPI = {
apiKey: 'your-api-key',
apiSecret: 'your-api-secret',
};
const client = new Wallet({ configurationRestAPI });
client.restAPI
.accountInfo()
.then((res) => res.data())
.then((data: WalletRestAPI.AccountInfoResponse) => console.log(data))
.catch((err) => console.error(err));
更多实例可见于 examples/rest-api 文件夹.
配置选项
REST API支持以下高级配置选项:
timeout: 请求超时以毫秒计( 默认: 1000 ms) .proxy: 代理配置 :host: 代理服务器主机名.port: 代理服务器端口.protocol: 代理协议(https或https).auth: 代理认证证书:username: 代理用户名.password: 代理密码.
keepAlive: 启用 HTTP 保留状态( 默认: 真) .compression: 启用响应压缩( 默认: true).retries: 对失败的请求进行重试的次数( 默认: 3) .backoff: 重试之间以毫秒计的延迟( 默认值: 1000 ms) .httpsAgent:用于高级TLS配置的自定义HTTPS代理.privateKey:RSA或ED25519 用于认证的私人密钥.privateKeyPassphrase:私人密钥的密码句,如果加密的话.
超时
您可以为请求配置超时, 以毫秒计 。 如果请求超过指定的超时,将中止。 见 超时示例 供详细使用.
代理服务器
REST API支持HTTP/HTTPS代理配置. 见 代理实例 供详细使用.
保留-生活
为持续连接启用 HTTP 保留状态 。 见 保持生命实例 供详细使用.
压缩
启用或禁用响应压缩 。 见 压缩示例 供详细使用.
检索
配置重试尝试和延迟的次数, 在失败请求的重试之间以毫秒计 。 见 重试示例 供详细使用.
HTTPS 代理服务器
自定义高级 TLS 配置的 HTTPS 代理 。 见 HTTPS (韩语) 代理实例 供详细使用.
基于密钥对等认证
REST API支持基于密钥的对等认证,用于安全通信. 你用得着 RSA 或者说 ED25519 用于签名请求的密钥。 见 基于密钥对等认证示例 供详细使用.
证书剪接
为了增强安全性,您可以使用证书标记 httpsAgent 选项。 这确保了客户端只使用特定证书与服务器进行通信. 见 证书剪接示例 供详细使用.
处理错误
REST API 提供了详细的出错类型来帮助您有效处理问题 :
ConnectorClientError: 一般客户端出错.RequiredError: 缺少所需参数时抛出.UnauthorizedError: 显示缺少或无效的认证证书.ForbiddenError: 禁止获取所请求的资源.TooManyRequestsError: 超过费率限额.RateLimitBanError:IP地址被禁,因为超过费率限制.ServerError: 内部服务器出错.NetworkError: 网络连接问题.NotFoundError: 资源未找到 .BadRequestError: 无效的请求.
见 处理错误实例 供详细使用.
若为 basePath 未提供,默认为 https://api.binance.com。 。 。 .
测试
为了进行测试:
npm install
npm run test
测试包括:
- REST API 终点
- 处理错误和边缘大小写
移徙指南
如果您正在升级到新的模块化结构,请参见 移徙指南 详细步骤.
捐款
欢迎捐款!
由于这个寄存器包含自动生成的代码,我们鼓励您首先打开一个GitHub问题来讨论您的想法或建议改进. 这有助于确保变化与项目目标和自动生成程序相一致.
协助:
- 打开一个 GitHub 问题 描述您的建议 或者您已经识别出的bug .
- 如果确定需要修改,维护者会将修改合并到主分支.
请保证所有测试都通过 如果你有直接的贡献。 仅在讨论和确认更改后提交拉动请求 .
谢谢你的贡献!
免责声明
此SDK由Binance在"如实"和"如实"的基础上提供,供您自己冒险使用. Binance没有就SDK的操作、其准确性、可靠性、完整性或适合任何特定目的作出任何说明或保证,无论是明示的还是暗示的.
在法律允许的最大限度内,Binance不承担由你使用或无法使用这种SDK引起的任何损失、损害或任何费用,包括但不限于由于SDK的错误、错误、中断或不准确造成的任何经济损失.
您使用此 SDK 访问 Binance 平台,须遵守 Binance API 关键名词和 Binance 使用名词,在与此免责声明相冲突时,该名词优先. 您只负责任何使用此 SDK 通过 Binance 平台执行的命令或交易 .
这一SDK并不打算构成投资建议或买卖或持有任何数字资产的建议。 您在行动前应独立评估并核实所有信息.
许可证
这个项目根据麻省理工学院的许可证获得许可。 见 属性 详细文件.