Skip to main content

​
Alpaca

ShanoneのAlpaca連携では、取引に関する44個のツールをエージェントに提供します。アカウント情報、注文、ポジション、ウォッチリスト、そして株式・暗号資産の両方のマーケットデータをカバーしています。
ライブ取引用のAPIキーを接続すると、Alpacaの注文・ポジション系ツールは実際の取引を実行し、実際のお金を動かします。引数を必ず確認し、エージェントのワークフローを構築・検証している間はペーパートレード用のキーを接続することを検討してください。

​
はじめに

1

APIキーペアを発行する

AlpacaダッシュボードのAPI Keysで、キーIDとシークレットキーを発行します — ペーパートレードの場合は、ライブキーではなくペーパートレード用のキーを使用してください。
2

Shanoneで接続する

エージェントにAlpacaで何か作業をしてもらう(例:「保有中のポジションを表示して」)か、ShanoneダッシュボードのインテグレーションからキーIDとシークレットキーを事前に登録します。
3

リクエストを再試行する

キーが保存されると、alpaca_*ツールに対するshanone_execute_toolの呼び出しが成功するようになります。

​
利用可能なツール

Shanoneは Alpaca向けに44個のツールを提供しており、以下のカテゴリに分類されています。
alpaca_get_account, alpaca_get_clock, alpaca_get_calendar, alpaca_list_assets, alpaca_get_asset, alpaca_get_account_configurations, alpaca_update_account_configurations, alpaca_get_account_activities
alpaca_create_order, alpaca_list_orders, alpaca_get_order, alpaca_get_order_by_client_id, alpaca_replace_order, alpaca_cancel_order, alpaca_cancel_all_orders
alpaca_list_positions, alpaca_get_position, alpaca_close_position, alpaca_close_all_positions, alpaca_get_portfolio_history
alpaca_list_watchlists, alpaca_get_watchlist, alpaca_create_watchlist, alpaca_update_watchlist, alpaca_add_watchlist_asset, alpaca_remove_watchlist_asset, alpaca_delete_watchlist
alpaca_get_stock_bars, alpaca_get_stock_latest_bars, alpaca_get_stock_quotes, alpaca_get_stock_latest_quotes, alpaca_get_stock_trades, alpaca_get_stock_latest_trades, alpaca_get_stock_snapshots
alpaca_get_crypto_bars, alpaca_get_crypto_latest_bars, alpaca_get_crypto_quotes, alpaca_get_crypto_latest_quotes, alpaca_get_crypto_trades, alpaca_get_crypto_latest_trades, alpaca_get_crypto_snapshots
alpaca_get_most_active_stocks, alpaca_get_market_movers, alpaca_get_news

​
よくある使い方

ポートフォリオの確認

保有ポジション・未実現損益・ポートフォリオの履歴をその場でまとめる

ウォッチリスト連動のアラート

ウォッチリストを追跡し、対象銘柄の目立った値動きやニュースを可視化する

注文ライフサイクルの管理

注文を発行・差し替え・取消し、alpaca_get_orderで約定状況を確認する

マーケットスクリーニング

さらに調査すべき銘柄を決める前に、その日の主要な活発銘柄・上位ムーバーを取得する

​
トラブルシューティング

注文サイズを調整する前に、alpaca_get_accountで現在の購買力を確認し、アカウントに制限(パターンデイトレードルールなど)がかかっていないか確認してください。
alpaca_get_clockとalpaca_get_calendarで市場が開いているか確認してください — 一部のsnapshot/latest系エンドポイントは直近セッションのデータしか反映しません。
ペーパートレードとライブ取引はAPIキーペアとアカウント状態がそれぞれ別です。Shanoneダッシュボードのインテグレーションでどちらのキーペアが接続されているか確認してください。