如何设置 Bitstamp API 密钥以进行自动交易？ （开发者工具）

API密钥生成过程

1. 使用经过验证的凭据通过https://www.bitstamp.net登录您的 Bitstamp 帐户。

2. 导航至右上角的用户菜单并选择“帐户设置”，然后单击左侧边栏中的“API 访问”。

3. 单击“创建新API密钥”，输入描述性标签，例如“TradingBot-Prod”，并选择严格限制为“余额”、“用户交易”、“开仓订单”、“取消订单”和“下订单”的权限。

4. 通过输入您的交易服务器或云实例的静态 IPv4 地址来启用 IP 地址限制；仅当使用动态 IP 处理进行本地部署时才保留空白。

5. 使用您的双因素身份验证设备确认创建； Bitstamp 立即显示 API 密钥和秘密密钥- 在关闭模式之前必须复制这两个值，因为秘密密钥永远不会再次显示。

安全加固要求

1. 将 API 密钥和密钥存储在版本控制之外的加密环境变量文件中；切勿将它们直接嵌入源代码或配置文件中。

2. 设立具有零提现能力的专用 Bitstamp 子账户，并仅使用用于自动执行的资金为其提供资金。

3. 关闭所有“提币”、“转账”、“账户管理”相关权限； Bitstamp 在 API 层强制执行此操作，而不仅仅是 UI 可见性。

4. 使用 Bitstamp 的密钥撤销界面每 90 天轮换一次密钥，并在所有连接的服务中重新部署更新的凭据。

5. 每天监控“API 访问日志”选项卡，以了解意外的请求时间戳、地理位置或表明凭证泄漏的异常高的调用量。

REST 端点集成

1. 所有经过身份验证的请求必须包含标头X-Auth ，其中包含由“ API key : API Secret ”形成的 Base64 编码字符串。

2. 使用端点https://www.bitstamp.net/api/v2/balance/验证连接；成功的响应返回带有“usd_balance”、“btc_balance”和“fee”字段的 JSON。

3. 要下限价单，请使用表单编码参数（包括“amount”、“price”和“limit_price”）POST 到https://www.bitstamp.net/api/v2/buy/btcusd/ 。

4. 在每个请求的“timestamp”参数中包含以毫秒为单位的 Unix 时间戳； Bitstamp 拒绝时间戳相对于服务器时间早于 30 秒或晚于 30 秒的请求。

5. 通过实施指数退避逻辑来处理 HTTP 429 响应 - Bitstamp 速率限制为每个 API 密钥每分钟 100 个请求。

WebSocket实时数据流

1. 使用支持 RFC 6455 的 WebSocket 客户端连接到wss://ws.bitstamp.net 。

2. 连接后立即发送订阅消息： {“event”:“bts:subscribe”,“data”:{“channel”:“live_trades_btcusd”}} 。

3. 解析传入的 JSON 有效负载，其中包含包含“id”、“price”、“amount”和“microtimestamp”字段的“data”数组，以获取滴答级执行信号。

4. 断开连接时自动重新连接，使用 1.2 至 2.8 秒之间的抖动间隔，以避免 Bitstamp 网关出现雷群效应。

5. 通过根据预期模式检查“通道”字段并丢弃缺少“数据”根对象的任何有效负载来验证消息的真实性。

常见问题解答

问：Bitstamp 是否支持像 Binance 或 OKX 一样基于签名的身份验证？ Bitstamp 不使用 HMAC-SHA256 签名。它仅依赖于 X-Auth 标头中的 Base64 编码的 API 密钥 + 秘密以及严格的时间戳验证。

问：我可以对 REST 和 WebSocket 连接使用相同的 API 密钥吗？是 - Bitstamp 颁发跨两个传输层有效的单个统一密钥对，无需单独的范围或令牌。

问：如果我的 API 密钥连续触发多个 429 错误，会发生什么情况？ Bitstamp 可能会暂时限制密钥长达 15 分钟；无需手动解锁，但重复违规可能会导致永久撤销。

问：是否有可用于 Bitstamp API 集成的测试网或沙箱环境？否 — Bitstamp 不提供官方暂存环境；开发人员必须使用小额实时订单，并在初始部署期间仔细监控余额变化。