加密货币交易
机器翻译译自英文(docs.alpaca.markets)本页 62 段已全部译完
🌍 要查看支持加密货币交易的美国地区,请点击 这里。
为账户启用加密货币
要为账户启用加密货币交易,用户必须签署加密货币协议。所有账户余额将反映加密货币交易活动。
对于新用户,加密货币协议可以通过 Accounts API 提交,其中 crypto_agreement 是 agreements 属性的一部分。
请求的一部分
{
"agreements": [
{
"agreement": "crypto_agreement",
"signed_at": "2023-01-01T18:09:33Z"
}
]
}对于现有用户,账户需要更新 crypto_agreement,可通过 PATCH /v1/accounts/{account_id} 端点提交。
请求的一部分
{
"agreements": [
{
"agreement": "crypto_agreement",
"signed_at": "2023-01-01T18:13:44Z",
"ip_address": "185.13.21.99"
}
]
}一旦加密货币协议添加到用户账户,就无法再对协议进行任何编辑。
要确定账户是否已准备好开始交易加密货币,请使用 Account API 端点响应对象中的 crypto_status 属性。
示例响应
{
"id": "9feee08f-22d2-4804-89c1-bf01166aad52",
"account_number": "943690069",
"status": "ACTIVE",
"crypto_status": "ACTIVE"
}| 属性 | 描述 |
|---|---|
| INACTIVE | 账户未启用加密货币实盘交易 |
| ACTIVE | 加密货币账户处于活跃状态,可以开始交易 |
| SUBMISSION_FAILED | 账户提交失败 |
支持的资产
我们通过 API 提供 20 多种可交易的币种。我们会持续评估该列表,并致力于增加支持的币种数量。
可交易的加密货币可通过 Assets API 识别,其中资产实体具有 class = crypto 和 tradable = true。
{
"id": "64bbff51-59d6-4b3c-9351-13ad85e3c752",
"class": "crypto",
"exchange": "CRXL",
"symbol": "BTC/USD",
"name": "Bitcoin",
"status": "active",
"tradable": true,
"marginable": false,
"shortable": false,
"easy_to_borrow": false,
"fractionable": true
}请注意,该符号以 USD 形式出现,例如 BTC/USD 而非 BTC。
🚧 加密货币费用收入通知
如果你启用非 USD 的加密货币交易,你将以计价货币收取费用。目前,非 USD 计价的加密资产有 BTC、USDC 和 USDT。作为经纪商业务,你需要准备好处理加密货币费用的收取,并在需要时进行必要的兑换。
最小订单规模
订单中可接受的最小数量值。该值根据所选的名义等价最小值动态计算,基于相关资产的最后收盘价。所有加密资产可接受的最大小数位数为 9,即 0.000000001。
对于 USD 交易对,最小订单规模的计算方式为:10/USD 资产价格。
对于 BTC、ETH 和 USDT 交易对,最小订单规模为 0.000000002。
最小交易增量
允许添加到 min_order_size 的最小数量。例如,如果为 0.1,我们接受 1.1 的订单,但不接受 0.9,因为它低于 min_order_size。所有加密资产可接受的最大小数位数为 9,即 0.000000001。
价格增量:订单中可接受的最小名义价值。与最小订单规模类似,但适用于名义订单。所有加密资产可接受的最大小数位数为 9,即 0.000000001。
所有加密货币资产都可以零碎数量交易,但支持的小数位数因加密货币而异。
支持的订单
通过 Orders API 提交加密货币订单时,支持 Market、Limit 和 Stop Limit 订单,支持的 time_in_force 取值为 gtc 和 ioc。我们也接受零碎数量订单,需提供 notional 或 qty。
必需披露
下面你将找到所需的披露模板,以便作为 Alpaca 的经纪商在你的应用中安全地支持加密货币。
开户披露
当你作为提供加密货币的经纪商为你的用户开户时,需要提供以下披露。在你的开户流程中,确保用户能够阅读并明确确认以下文本,例如通过单独的复选框:
我已阅读、理解并同意受 Alpaca Crypto LLC 和 [你的法律实体] 的账户条款,以及适用于我的所有其他条款、披露和免责声明(如 Alpaca Crypto 协议中所引用)的约束。我还确认 Alpaca Crypto 协议第 26 条包含争议前仲裁条款。
买入/卖出订单界面披露
作为允许提交加密货币订单的经纪商,在用户提交买入或卖出订单之前,以下披露应立即显示在用户的订单录入界面(应用或网站)上。
买入订单披露
通过下达买入 [$ 金额 / 数量 ] [加密货币] 的订单,你指示并授权 Alpaca Securities LLC 从你的 Alpaca Securities LLC 账户向你的 Alpaca Crypto LLC 账户转入支付购买成本所需的资金。加密货币服务由 Alpaca Crypto LLC 提供。加密货币不是证券,不受 FDIC 保险,也不受 SIPC 保护。披露。
卖出订单披露
通过下达卖出 [$ 金额 / 数量 ] [加密货币] 的订单,你指示并授权 Alpaca Crypto LLC 将卖出所得的已结算资金转入你的 Alpaca Securities LLC 账户。加密货币服务由 Alpaca Crypto LLC 提供。加密货币不是证券,不受 FDIC 保险,也不受 SIPC 保护。披露。
加密货币交易对订单披露
通过下达订单,你指示并授权 Alpaca Crypto LLC 将 [X 数量的加密货币] 兑换为 [Y 数量的加密货币]。加密货币服务由 Alpaca Crypto LLC 提供。加密货币不是证券,不受 FDIC 保险,也不受 SIPC 保护。
保证金与卖空
加密货币不可使用保证金。这意味着你不能使用杠杆购买它们,订单会根据 non_marginable_buying_power 进行评估。
加密货币不可卖空。
交易时间
加密货币交易每天 24 小时提供,你的订单将在全天执行。
交易限制
目前,单笔订单(买入或卖出)的名义金额不得超过 20 万美元。这是按单笔订单计算的。
加密货币订单佣金
经纪商可以通过在提交订单时包含佣金参数,对每笔加密货币订单收取佣金。加密货币的佣金支持现在包括 notional 和 bps(基点)两种佣金类型。金额以交易对的计价货币(对于 notional)或 bps 的百分比形式指定。
要启用佣金支持,经纪商必须先联系 Alpaca 配置其佣金结构。设置完成后,可以在每个订单请求中提供佣金金额,该金额也会出现在 API 响应的订单实体中。
对于所有订单(无论佣金类型如何),如果订单有多次执行,则每次执行时收取的佣金将按比例分摊。例如,如果订单的 10% 在一次执行中成交,那么该次执行的佣金将是总佣金的 10%。
佣金类型:
- Notional:按每笔订单收取佣金。当订单请求中省略 commission_type 字段时,默认使用此类型。
- Bps:向最终用户按订单收取的百分比佣金(以基点表示)。Alpaca 会将订单转换为名义金额以计算佣金。
市场数据
Alpaca 从多个交易场所提供加密货币数据。
Alpaca 使用的加密货币数据提供商:
| 交易所 | 交易所代码 |
|---|---|
CBSE | Coinbase |
CRXL | Alpaca Crypto Exchange |
FLCX | Falcon X |
功能
价格区间保护
Alpaca 的价格区间校验会阻止交易在外部参考价格周围预定义百分比范围之外执行。这确保了市场稳定性,并防止因错误交易导致的极端价格波动。外部参考价格由 Coinbase、FalconX 和 StillmanDigital 按加权平均计算得出。
将以无效价格执行的订单会被自动取消,原因如下。
- 由于参考价格过期而取消 – 订单被取消,因为用于价格区间校验的参考价格已过期。
- 由于价格区间保护而取消。指数价格:
<index_price>价格区间:<price_band>%,被拒绝的价格:<maker_order_price>– 订单即将以超出允许范围的价格成交