加密货币现货交易
机器翻译译自英文(docs.alpaca.markets)本页 38 段已全部译完
🚧 自 2022 年 11 月 18 日起,加密货币交易已向部分国际司法管辖区和部分美国司法管辖区开放。
要查看支持加密货币交易的美国地区,请点击 这里。
支持的币种
Alpaca 支持 56 个交易对中的 20 多种独特加密资产。当前交易对基于 BTC、USD、USDT 和 USDC),更多资产和交易对即将推出。
要查询所有可用的加密资产和交易对,你可以使用以下 API 调用:
curl --request GET 'https://api.alpaca.markets/v2/assets?asset_class=crypto' \
--header 'Apca-Api-Key-Id: <KEY>' \
--header 'Apca-Api-Secret-Key: <SECRET>'下面是一个示例交易对对象,由 BTC 和 USD 两种资产组成。
{
"id": "276e2673-764b-4ab6-a611-caf665ca6340",
"class": "crypto",
"exchange": "ALPACA",
"symbol": "BTC/USD",
"name": "BTC/USD pair",
"status": "active",
"tradable": true,
"marginable": false,
"shortable": false,
"easy_to_borrow": false,
"fractionable": true,
"min_order_size": "0.0001",
"min_trade_increment": "0.0001",
"price_increment": "1"
}请注意,交易对的符号表示法已与我们之前的格式不同,BTC/USD 之前被称为 BTCUSD。我们的 API 也已做出相应更改,以同时支持旧有约定,实现向后兼容。
有关更多参考,请参阅 Assets API。添加链接
支持的订单
通过 Orders API 和 Alpaca Web 仪表盘提交加密货币订单时,支持 Market、Limit 和 Stop Limit 订单,支持的 time_in_force 取值为 gtc 和 ioc。我们也接受碎股订单,需提供 notional 或 qty。
你可以通过 API 为任何支持的加密货币交易对提交订单,参见下面的 cURL POST 请求。
curl --request POST 'https://paper-api.alpaca.markets/v2/orders' \
--header 'Apca-Api-Key-Id: <KEY>' \
--header 'Apca-Api-Secret-Key: <SECRET>' \
--header 'Content-Type: application/json' \
--data-raw '{
"symbol": "BTC/USD",
"qty": "0.0001",
"side": "buy",
"type": "market",
"time_in_force": "gtc"
}'上述请求通过 API 提交了一笔市价单,用 USD(BTC/USD 交易对)买入 0.0001 BTC,订单有效期为当日有效(good till end of day)。
要了解更多,请参阅 orders 和 fractional trading。
所有加密货币资产都可以碎股交易,但支持的小数位数因加密货币而异。有关每种资产的碎股精度信息,请参阅 Assets entity。
请注意这些值将来可能会发生变化。
加密货币市场数据
这里我们提供一个示例,请求以下三个币对的最新订单簿数据(买价和卖价):BTC/USD、ETH/BTC 和 ETH/USD。
curl 'https://data.alpaca.markets/v1beta3/crypto/us/latest/orderbooks?symbols=BTC/USD,ETH/BTC,ETH/USD'{
"orderbooks": {
"BTC/USD": {
"a": [
{
"p": 66051.621,
"s": 0.275033
},
...
],
"b": [
{
"p": 65986.962,
"s": 0.27813
},
...
],
"t": "2024-07-24T07:31:01.373709495Z"
},
"ETH/USD": { ... }
},
"ETH/BTC": { ... }
}
}此外,你还可以通过 WebSocket 订阅实时加密货币数据。下面的示例使用 wscat 订阅 BTC/USD 订单簿。
$ wscat -c wss://stream.data.alpaca.markets/v1beta3/crypto/us
Connected (press CTRL+C to quit)
< [{"T":"success","msg":"connected"}]
> {"action":"auth","key":"<YOUR API KEY>","secret":"<YOUR API SECRET>"}
< [{"T":"success","msg":"authenticated"}]
> {"action":"subscribe","quotes":["ETH/USD"]}
< [{"T":"subscription","trades":[],"quotes":["ETH/USD"],"orderbooks":[],"bars":[],"updatedBars":[],"dailyBars":[]}]
< [{"T":"q","S":"ETH/USD","bp":3445.34,"bs":4.339,"ap":3450.2,"as":4.3803,"t":"2024-07-24T07:38:06.88490478Z"}]
< [{"T":"q","S":"ETH/USD","bp":3445.34,"bs":4.339,"ap":3451.1,"as":8.73823,"t":"2024-07-24T07:38:06.88493591Z"}]
< [{"T":"q","S":"ETH/USD","bp":3445.34,"bs":4.339,"ap":3447.03,"as":4.36424,"t":"2024-07-24T07:38:06.88511154Z"}]
< [{"T":"q","S":"ETH/USD","bp":3444.644,"bs":8.797,"ap":3447.03,"as":4.36424,"t":"2024-07-24T07:38:06.88512141Z"}]
< [{"T":"q","S":"ETH/USD","bp":3444.51,"bs":4.33,"ap":3447.03,"as":4.36424,"t":"2024-07-24T07:38:06.88516355Z"}]有关实时加密货币定价数据的更多参考,请参阅其文档。
转账加密货币
Alpaca 现在通过钱包提供原生链上加密货币转账!如果你已启用加密货币交易,并且居住在美国合格州或国际司法管辖区,你可以通过 Crypto Transfers 标签页在 Web 仪表盘上访问钱包。
Alpaca 钱包目前支持 Bitcoin、Ethereum 以及所有基于 Ethereum(ERC20)的代币的转账。要了解更多关于使用 Alpaca 转账加密货币的信息,请参阅 Crypto Wallets FAQs
加密货币现货交易费用
Alpaca 的股票交易仍然免佣金,但加密货币交易会根据你的成交量和订单类型对每笔交易收取少量费用。任何市场或交易所都由买卖双方两方组成。当你在 Alpaca 交易所下达买入加密货币的订单时,交易的另一方有其他人正在卖出你想买入的资产。卖方在订单簿上挂出的订单为交易所提供了流动性,使交易得以进行。请注意,买卖双方都可能是 maker 或 taker,取决于提交的订单和该币种的当前报价。Maker 是增加流动性的人,其订单会被挂到订单簿上。而 Taker 则通过下市价单或可成交的限价单来移除流动性,这些订单会与已挂出的订单成交。
参见下表,了解按交易量分层的费用定价:
| 层级 | 30 天交易量(USD) | Maker | Taker |
|---|---|---|---|
| 1 | 0 - 100,000 | 15 bps | 25 bps |
| 2 | 100,000 - 500,000 | 12 bps | 22 bps |
| 3 | 500,000 - 1,000,000 | 10 bps | 20 bps |
| 4 | 1,000,000 - 10,000,000 | 8 bps | 18 bps |
| 5 | 10,000,000 - 25,000,000 | 5 bps | 15 bps |
| 6 | 25,000,000 - 50,000,000 | 2 bps | 13 bps |
| 7 | 50,000,000 - 100,000,000 | 2 bps | 12 bps |
| 8 | 100,000,000+ | 0 bps | 10 bps |
加密货币费用将按每笔交易,向入账的加密资产/法币(即你收到的资产)收取。下面是一些示例,
- 买入
ETH/BTC,你收到ETH,费用以ETH计价 - 卖出
ETH/BTC,你收到BTC,费用以BTC计价 - 买入
ETH/USD,你收到ETH,费用以ETH计价 - 卖出
ETH/USD,你收到USD,费用以USD计价
要获取加密货币交易产生的费用,你可以使用 Activities API,按 CFEE 或 FEE 查询 activity_type。参见以下 CFEE 对象示例:
{
"id": "20220812000000000::53be51ba-46f9-43de-b81f-576f241dc680",
"activity_type": "CFEE",
"date": "2022-08-12",
"net_amount": "0",
"description": "Coin Pair Transaction Fee (Non USD)",
"symbol": "ETHUSD",
"qty": "-0.000195",
"price": "1884.5",
"status": "executed"
}目前费用按日终计算并记账。如果你在交易当天查询,可能无法获得结果。我们将在不久后提供更新,使费用记账变为实时。
保证金与卖空
加密货币不能以保证金购买。这意味着你不能使用杠杆购买它们,订单会根据 non_marginable_buying_power 进行评估。
加密货币不可卖空。
交易时间
加密货币交易每天 24 小时提供,你的订单将在全天执行。
交易限制
目前,单笔订单(买入或卖出)的名义金额不得超过 20 万美元。这是按单笔订单计算的。