API Bitstamp
Bitstamp
Bitstamp 是一家位于卢森堡的比特币交易所。它允许在 USD 货币和比特币加密货币之间交易。支持美元、欧元、比特币、莱特币、以太坊、瑞波币或比特币现金的存款和提款。
- 支持最新的 WebSocket API V2。
- 支持以下 REST API 端点:账户余额、用户交易、手续费、订单、提现、充值地址、子账户划转、理财/质押、旅行规则 和 市场。
配置
私有 API 需要您从 Bitstamp 账户创建 API 密钥。获取 API 密钥后,请在以下属性中配置这些密钥:
- Bitstamp.ApiKey
- Bitstamp.ApiSecret
WebSocket 公共方法
SubscribeLiveTicker:获取所选货币的实时成交数据。JSON 数据:
| 属性 |
描述 |
| id |
成交唯一 ID。 |
| amount |
交易金额。 |
| amount_str |
以字符串格式表示的交易金额。 |
| price |
成交价格。 |
| price_str |
以字符串格式表示的交易价格。 |
| type |
交易类型(0 - 买入;1 - 卖出)。 |
| timestamp |
交易时间戳。 |
| microtimestamp |
交易微时间戳。 |
| buy_order_id |
交易买单 ID。 |
| sell_order_id |
交易卖单 ID。 |
SubscribeLiveOrders: 获取所选货币的实时订单。JSON 数据:
| 属性 |
描述 |
| id |
订单 ID。 |
| amount |
订单金额。 |
| amount_str |
订单金额,以字符串格式表示。 |
| price |
订单价格。 |
| price_str |
以字符串格式表示的订单价格。 |
| order_type |
订单类型(0 - 买入;1 - 卖出)。 |
| datetime |
订单日期时间。 |
| microtimestamp |
以微秒表示的订单操作时间戳。 |
SubscribeLiveOrderBook: 获取所选货币的实时订单簿。JSON 数据:
| 属性 |
描述 |
| bids |
前 100 个最优买价列表。 |
| asks |
前 100 个卖出挂单列表。 |
| timestamp |
订单簿时间戳。 |
| microtimestamp |
订单簿微时间戳。 |
SubscribeLiveDetailOrderBook: 获取所选货币的实时详细订单簿。JSON 数据:
| 属性 |
描述 |
| bids |
前 100 个买单列表 [价格、数量、订单 ID]。 |
| asks |
前 100 个卖出挂单列表 [价格,数量,订单 ID]。 |
| timestamp |
订单簿时间戳。 |
| microtimestamp |
订单簿微时间戳。 |
SubscribeLiveFullOrderBook:获取所选货币的实时完整订单簿。JSON 数据:
| 属性 |
描述 |
| bids |
自上次广播以来更改的买单列表。 |
| asks |
自上次广播以来变化的卖单列表。 |
| timestamp |
订单簿时间戳。 |
| microtimestamp |
订单簿微时间戳。 |
WebSocket 私有方法
SubscribeMyOrders: 获取已发送订单的更新。JSON 数据:
| 属性 |
描述 |
| id |
订单 ID。 |
| id_str |
以字符串格式表示的订单 ID。 |
| client_order_id |
客户端订单 ID(如果在下单时使用了该 ID)。 |
| amount |
订单金额。 |
| amount_str |
订单金额,以字符串格式表示。 |
| price |
订单价格。 |
| price_str |
以字符串格式表示的订单价格。 |
| order_type |
订单类型(0 - 买入,1 - 卖出)。 |
| datetime |
订单日期时间。 |
| microtimestamp |
以微秒表示的订单操作时间戳。 |
SubscribeMyTrades:获取交易更新。JSON 数据:
| 属性 |
描述 |
| id |
交易 ID。 |
| order_id |
与该交易关联的订单 ID。 |
| client_order_id |
与该交易关联的客户端订单 ID。 |
| amount |
交易金额。 |
| price |
成交价格。 |
| fee |
交易手续费。 |
| side |
交易方向(买入或卖出)。 |
| microtimestamp |
以微秒为单位表示的交易时间戳。 |
REST API 公共方法
行情
- GetCurrencies:返回所有货币及基本数据的列表。
- GetAllCurrencyPairsTickers:返回所有货币对的 ticker 数据。传入任何 GET 参数将导致请求被拒绝。
- GetCurrencyPairTicker:返回所请求货币对的行情数据。传递任何 GET 参数都将导致请求被拒绝。
- GetHourlyTicker: 返回所请求货币对的每小时行情数据。传入任何 GET 参数都将导致请求被拒绝。
订单簿
交易
- GetTransactions: 返回给定时间范围内的交易数据。
市场信息
- GetEURUSDConversionRate:返回欧元/美元汇率。
- GetOLHCData: 通过 API 请求返回 OHLC(开盘价、最高价、最低价、收盘价)数据的视图。
- GetTradingPairsInfo:返回交易对信息。
- GetMarkets:返回所有可用市场及基本数据的列表。
旅行规则
- GetTravelRuleVASPs:返回用于旅行规则合规的虚拟资产服务提供商(VASP)列表。
REST API 私有方法
账户余额
- GetAccountBalances:返回账户余额。
- GetAccountBalanceForCurrency: 返回指定货币的账户余额。
订单
- BuyInstantOrder:下达即时买入订单。下达即时订单即表明您认可该订单的执行取决于市场条件,且这些条件可能受到无法预见的突发变化的影响。此调用将在所用 API 密钥绑定的账户(子账户或主账户)上执行。
- BuyMarketOrder: 开市价买入订单。下市价单即表示您接受订单的执行依赖于市场条件,且这些条件可能随时发生无法预见的变化。此调用将在绑定所用 API 密钥的账户(子账户或主账户)上执行。
- BuyLimitOrder:开立买入限价单。此调用将在绑定所用 API 密钥的账户(子账户或主账户)上执行。
- CancelAllOrders: 取消所有未成交订单。此调用将在绑定所用 API 密钥的账户(子账户或主账户)上执行。
- CancelAllOrdersForCurrencyPair:取消某货币对的所有未结订单。此调用将在与所用 API 密钥绑定的账户(子账户或主账户)上执行。
- CancelOrder: 取消订单。此调用将在使用的 API 密钥绑定的账户(子账户或主账户)上执行。
- GetTradingPairs: 返回所选账户上可以交易的所有交易对。
- GetAllOpenOrders: 返回用户的所有挂单。该 API 调用缓存 10 秒。此调用将在与所用 API 密钥绑定的账户(子账户或主账户)上执行。
- GetOpenOrders: 返回用户指定货币对的未结订单。此 API 调用缓存 10 秒。此调用将在所用 API 密钥绑定的账户(子账户或主账户)上执行。
- GetOrderStatus: 返回订单状态。此调用将在与所用 API 密钥绑定的账户(子账户或主账户)上执行。可以使用 id 或 client_order_id 参数来查询订单。对于已关闭的订单,此调用仅返回最近 30 天内的信息。超出此时间范围的订单将返回"订单未找到"错误。
- SellInstantOrder: 开立即时卖出订单。下达即时订单即表示您确认,订单的执行取决于市场状况,而这些状况可能受到无法预见的突然变化的影响。本次调用将在与所用 API 密钥绑定的账户(子账户或主账户)上执行。
- SellMarketOrder: 开立卖方市价单。通过下市价单,您确认您的订单执行取决于市场状况,而这些状况可能会受到无法预见的突然变化的影响。此调用将在与所用 API 密钥绑定的账户(子账户或主账户)上执行。
- SellLimitOrder:下卖出限价单。此调用将在与所使用 API 密钥绑定的账户上执行。
提款
- RippleIOUWithdrawal:此调用将在与所用 API 密钥绑定的账户(子账户或主账户)上执行。此端点支持在 XRP 账本上提取 USD、BTC 或 EUR IOU。
- WithdrawalRequests: 返回用户的提款请求。此调用将在与所用 API 密钥绑定的账户(子账户或主账户)上执行。
- CancelBankOrCryptoWithdrawal: 取消银行或加密货币提款请求。此操作只能由主账户执行。
- OpenBankWithdrawal:发起银行提款请求(SEPA 或国际汇款)。通过 API 发起的提款请求会自动确认(不会发送确认邮件),但处理方式与通过平台界面发起的提款相同。此调用只能由您的主账户执行。
- FiatWithdrawalStatus:检查法币提款请求的状态。此调用只能由您的主账户执行。
- CryptoWithdrawal: 请求加密货币提款。
用户交易
- GetUserTransactions:返回所有用户交易。支持 limit、offset 和 sort 参数。
- GetUserTransactionsForCurrencyPair:返回特定货币对的用户交易记录,支持 limit、offset 和 sort 参数。
手续费
- GetTradingFees: 返回所有交易费用。
- GetTradingFeesForCurrencyPair:返回特定货币对的交易手续费。
- GetWithdrawalFees:返回所有货币的提款手续费。
充值地址
- GetCryptoDepositAddress: 返回指定加密货币的充币地址。
子账户转账
- TransferToMain: 将资金从子账户划转到主账户。
- TransferFromMain:将资金从主账户转移到子账户。
赚币 / 质押
- EarnSubscribe: 订阅指定货币和金额的 Earn 计划。
- EarnUnsubscribe: 取消指定货币和金额的 Earn 计划订阅。
- GetEarnSubscriptions: 返回当前的 Earn 订阅。
- GetEarnTransactions:返回理财交易历史(奖励、订阅、取消订阅)。