Loading...
Loading...
Compare original and translation side by side
https://paper-api.alpaca.marketshttps://api.alpaca.marketspip install alpaca-pyhttps://paper-api.alpaca.marketshttps://api.alpaca.marketspip install alpaca-pyimport os
from alpaca.trading.client import TradingClientimport os
from alpaca.trading.client import TradingClient
**⚠️ NUNCA hardcodear keys. Usar variables de entorno.**
---
**⚠️ 切勿硬编码密钥,请使用环境变量。**
---| API | Límite |
|---|---|
| Orders | 200 requests/min |
| Account/Positions | 200 requests/min |
| Account Activities | 200 requests/min |
| API | 限制 |
|---|---|
| 订单 | 200次请求/分钟 |
| 账户/仓位 | 200次请求/分钟 |
| 账户活动 | 200次请求/分钟 |
account = client.get_account()
print(f"Buying Power: ${account.buying_power}")
print(f"Cash: ${account.cash}")
print(f"Portfolio Value: ${account.portfolio_value}")
print(f"Status: {account.status}")account = client.get_account()
print(f"购买力: ${account.buying_power}")
print(f"现金余额: ${account.cash}")
print(f"投资组合价值: ${account.portfolio_value}")
print(f"账户状态: {account.status}")from alpaca.trading.requests import AccountConfigurationsRequest
config_request = AccountConfigurationsRequest(
trade_confirmation_email=True,
susi_transfer_email=True
)
client.update_account_configuration(config_request)from alpaca.trading.requests import AccountConfigurationsRequest
config_request = AccountConfigurationsRequest(
trade_confirmation_email=True,
susi_transfer_email=True
)
client.update_account_configuration(config_request)from alpaca.trading.requests import GetAssetsRequest
from alpaca.trading.enums import AssetClass, AssetStatus
request = GetAssetsRequest(
asset_class=AssetClass.US_EQUITY,
status=AssetStatus.ACTIVE
)
assets = client.get_all_assets(request)from alpaca.trading.requests import GetAssetsRequest
from alpaca.trading.enums import AssetClass, AssetStatus
request = GetAssetsRequest(
asset_class=AssetClass.US_EQUITY,
status=AssetStatus.ACTIVE
)
assets = client.get_all_assets(request)undefinedundefinedasset = client.get_asset("AAPL")
print(f"AAPL tradable: {asset.tradable}")
print(f"AAPL class: {asset.asset_class}")asset = client.get_asset("AAPL")
print(f"AAPL是否可交易: {asset.tradable}")
print(f"AAPL资产类别: {asset.asset_class}")| Tipo | Descripción |
|---|---|
| Ejecuta al precio actual |
| Precio máximo (buy) o mínimo (sell) |
| Activa orden de mercado cuando alcanza stop_price |
| Combina stop + limit |
| Stop relativo al precio |
| 类型 | 描述 |
|---|---|
| 按当前市价执行 |
| 设置买入最高价或卖出最低价 |
| 价格达到止损价时触发市价订单 |
| 结合止损与限价订单 |
| 相对价格的止损订单 |
| TIF | Descripción |
|---|---|
| Solo para día actual |
| Good Till Cancelled |
| Open at market open |
| Close at market close |
| Immediate Or Cancel |
| Fill Or Kill |
| TIF | 描述 |
|---|---|
| 仅当日有效 |
| 未撤销前持续有效 |
| 开盘时执行 |
| 收盘时执行 |
| 立即执行未成交部分撤销 |
| 全部成交否则撤销 |
from alpaca.trading.requests import MarketOrderRequest
from alpaca.trading.enums import OrderSide, TimeInForce
order_request = MarketOrderRequest(
symbol="AAPL",
qty=10,
side=OrderSide.BUY,
time_in_force=TimeInForce.DAY
)
order = client.submit_order(order_request)
print(f"Order ID: {order.id}")
print(f"Status: {order.status}")from alpaca.trading.requests import MarketOrderRequest
from alpaca.trading.enums import OrderSide, TimeInForce
order_request = MarketOrderRequest(
symbol="AAPL",
qty=10,
side=OrderSide.BUY,
time_in_force=TimeInForce.DAY
)
order = client.submit_order(order_request)
print(f"订单ID: {order.id}")
print(f"订单状态: {order.status}")from alpaca.trading.requests import LimitOrderRequest
order_request = LimitOrderRequest(
symbol="AAPL",
qty=10,
side=OrderSide.BUY,
limit_price=150.00, # Máximo a pagar
time_in_force=TimeInForce.GTC
)
order = client.submit_order(order_request)from alpaca.trading.requests import LimitOrderRequest
order_request = LimitOrderRequest(
symbol="AAPL",
qty=10,
side=OrderSide.BUY,
limit_price=150.00, # 最高买入价
time_in_force=TimeInForce.GTC
)
order = client.submit_order(order_request)from alpaca.trading.requests import StopOrderRequest
order_request = StopOrderRequest(
symbol="AAPL",
qty=10,
side=OrderSide.SELL,
stop_price=145.00, # Vende cuando caiga a este precio
time_in_force=TimeInForce.GTC
)from alpaca.trading.requests import StopOrderRequest
order_request = StopOrderRequest(
symbol="AAPL",
qty=10,
side=OrderSide.SELL,
stop_price=145.00, # 价格跌至该值时卖出
time_in_force=TimeInForce.GTC
)undefinedundefinedundefinedundefinedundefinedundefinedundefinedundefinedfrom alpaca.trading.requests import ReplaceOrderRequest
replace_request = ReplaceOrderRequest(
limit_price=155.00, # Nuevo precio límite
qty=15 # Nueva cantidad
)
client.replace_order(order_id, replace_request)from alpaca.trading.requests import ReplaceOrderRequest
replace_request = ReplaceOrderRequest(
limit_price=155.00, # 新的限价
qty=15 # 新的数量
)
client.replace_order(order_id, replace_request)positions = client.get_all_positions()
for pos in positions:
print(f"{pos.symbol}: {pos.qty} shares")
print(f" Avg Entry: ${pos.avg_entry_price}")
print(f" Market Value: ${pos.market_value}")
print(f" P/L: ${pos.unrealized_pl}")positions = client.get_all_positions()
for pos in positions:
print(f"{pos.symbol}: {pos.qty} 股")
print(f" 平均入场价: ${pos.avg_entry_price}")
print(f" 市值: ${pos.market_value}")
print(f" 浮动盈亏: ${pos.unrealized_pl}")position = client.get_position("AAPL")
print(f"AAPL: {position.qty} shares @ ${position.avg_entry_price}")position = client.get_position("AAPL")
print(f"AAPL: {position.qty} 股 @ ${position.avg_entry_price}")undefinedundefinedundefinedundefinedclient.close_all_positions()client.close_all_positions()| Level | Descripción |
|---|---|
| 0 | Sin trading de opciones |
| 1 | Covered calls, cash-secured puts |
| 2 | Buy/sell calls y puts |
| 3 | Spreads |
| 等级 | 描述 |
|---|---|
| 0 | 不允许期权交易 |
| 1 | 备兑看涨期权、现金担保看跌期权 |
| 2 | 买入/卖出看涨期权和看跌期权 |
| 3 | 期权价差策略 |
from alpaca.trading.requests import GetOptionContractsRequest
from datetime import datetime, timedelta
request = GetOptionContractsRequest(
underlying_symbols=["AAPL"],
expiration_date_gte=datetime.now().strftime("%Y-%m-%d"),
expiration_date_lte=(datetime.now() + timedelta(days=30)).strftime("%Y-%m-%d"),
strike_price_gte=100,
strike_price_lte=200,
limit=100
)
contracts = client.get_option_contracts(request)
contract = contracts.option_contracts[0]from alpaca.trading.requests import GetOptionContractsRequest
from datetime import datetime, timedelta
request = GetOptionContractsRequest(
underlying_symbols=["AAPL"],
expiration_date_gte=datetime.now().strftime("%Y-%m-%d"),
expiration_date_lte=(datetime.now() + timedelta(days=30)).strftime("%Y-%m-%d"),
strike_price_gte=100,
strike_price_lte=200,
limit=100
)
contracts = client.get_option_contracts(request)
contract = contracts.option_contracts[0]undefinedundefinedundefinedundefined
---
---from alpaca.trading.enums import AssetClass
crypto_assets = client.get_all_assets(asset_class=AssetClass.CRYPTO)
crypto = [a for a in crypto_assets if a.tradable]
print(f"Crypto tradables: {[a.symbol for a in crypto[:10]]}")from alpaca.trading.enums import AssetClass
crypto_assets = client.get_all_assets(asset_class=AssetClass.CRYPTO)
crypto = [a for a in crypto_assets if a.tradable]
print(f"可交易加密货币: {[a.symbol for a in crypto[:10]]}")order_request = MarketOrderRequest(
symbol="BTC/USD",
qty=0.1, # Fracciones permitidas
side=OrderSide.BUY,
time_in_force=TimeInForce.GTC
)
client.submit_order(order_request)order_request = MarketOrderRequest(
symbol="BTC/USD",
qty=0.1, # 允许 fractional 交易
side=OrderSide.BUY,
time_in_force=TimeInForce.GTC
)
client.submit_order(order_request)clock = client.get_clock()
print(f"Market open: {clock.is_open}")
print(f"Next open: {clock.next_open}")
print(f"Next close: {clock.next_close}")clock = client.get_clock()
print(f"市场是否开盘: {clock.is_open}")
print(f"下次开盘时间: {clock.next_open}")
print(f"下次收盘时间: {clock.next_close}")if clock.is_open:
print("Mercado abierto - puedes tradear")
else:
print("Mercado cerrado")if clock.is_open:
print("市场已开盘 - 可以交易")
else:
print("市场已收盘")from datetime import datetime
history = client.get_account_portfolio_history(
date_start=datetime(2024, 1, 1),
timeframe="1D"
)
print(f"Equity: {history.equity}")
print(f"Profit/Loss: {history.profit_loss}")from datetime import datetime
history = client.get_account_portfolio_history(
date_start=datetime(2024, 1, 1),
timeframe="1D"
)
print(f"权益: {history.equity}")
print(f"盈亏: {history.profit_loss}")from alpaca.trading.requests import CreateWatchlistRequestfrom alpaca.trading.requests import CreateWatchlistRequest
---
---from alpaca.trading.stream import TradingStream
async def handle_trade_update(data):
print(f"Update: {data}")
stream = TradingStream(API_KEY, SECRET_KEY, paper=True)
stream.subscribe_trade_updates(handle_trade_update)
stream.run()from alpaca.trading.stream import TradingStream
async def handle_trade_update(data):
print(f"更新: {data}")
stream = TradingStream(API_KEY, SECRET_KEY, paper=True)
stream.subscribe_trade_updates(handle_trade_update)
stream.run()undefinedundefined
---
---| Error | Causa | Solución |
|---|---|---|
| 403 Forbidden | Keys inválidas | Verificar API keys |
| 403 | Sin permisos | Habilitar en dashboard |
| 400 Bad Request | Parámetros inválidos | Ver docs de orden |
| 403 Trading Halted | Trading pausado | Esperar o verificar |
| 403 No Buying Power | Sin fondos | Depositar dinero |
| 422 | Symbol no tradable | Verificar symbol |
| 429 Too Many Requests | Rate limit | Implementar backoff |
| 错误 | 原因 | 解决方案 |
|---|---|---|
| 403 Forbidden | 密钥无效 | 检查API密钥 |
| 403 | 无权限 | 在控制台启用权限 |
| 400 Bad Request | 参数无效 | 查看订单文档 |
| 403 Trading Halted | 交易暂停 | 等待或检查状态 |
| 403 No Buying Power | 无可用资金 | 存入资金 |
| 422 | 标的不可交易 | 检查标的符号 |
| 429 Too Many Requests | 触发速率限制 | 实现退避机制 |
| Aspecto | Paper | Live |
|---|---|---|
| URL | paper-api.alpaca.markets | api.alpaca.markets |
| Dinero real | ❌ No | ✅ Sí |
| Órdenes reales | ❌ Simuladas | ✅ Reales |
| Datos de mercado | ✅ Reales | ✅ Reales |
| Para testing | ✅ Ideal | ❌ No |
| 方面 | 模拟交易 | 实盘交易 |
|---|---|---|
| URL | paper-api.alpaca.markets | api.alpaca.markets |
| 真实资金 | ❌ 否 | ✅ 是 |
| 真实订单 | ❌ 模拟 | ✅ 真实 |
| 市场数据 | ✅ 真实 | ✅ 真实 |
| 用于测试 | ✅ 理想 | ❌ 不建议 |