orderly-onboarding

Orderly Network: エージェントのオンボーディング

Orderly は、分散型取引所に無期限先物の流動性を提供する、オムニチェーン型のオーダーブックベースの取引インフラストラクチャです。このスキルは、Orderly Network 上で構築したり、Orderly Network について学んだりするための出発点となります。

使用する場面

• 初めて Orderly Network に触れるとき
• Orderly の開発向けに AI エージェントツールをセットアップするとき
• Orderly のエコシステムと提供内容を理解したいとき
• 自分のタスクに適したスキルやリソースを見つけたいとき
• AI エージェント向けにどのようなツールが利用できるかを理解したいとき

Orderly Network とは

Orderly は、オーダーブックベースの取引インフラストラクチャと、無期限先物のオーダーブックを提供する堅牢な流動性レイヤーを組み合わせたものです。従来のプラットフォームとは異なり、Orderly にはフロントエンドがありません。エコシステムの中核で動作し、その上に構築されるプロジェクトに不可欠なサービスを提供します。

主な特徴:

• オムニチェーン CLOB: すべての主要な EVM チェーンと Solana からアクセスできる共有セントラルリミットオーダーブック
• バックエンドインフラストラクチャ: 公式のフロントエンドはなく、ビルダーがその上に DEX や取引インターフェースを作成します
• オンチェーン決済: すべての取引は完全なセルフカストディを維持したままオンチェーンで決済されます
• 統合された流動性: 1 つのオーダーブックがすべての統合されたフロントエンドにサービスを提供します
• 無期限先物: BTC、ETH、SOL などを最大 50 倍のレバレッジで取引できます
• ガスレス取引: 資金を入金し取引キーを有効化すれば、ガス代はかかりません
• ワンクリック取引: セッションごとに新しい取引キーペアを作成し、それ以降の署名は不要です

主なユースケース:

ユースケース	説明
ビルダー/DEX	プラグアンドプレイの SDK を使って、EVM と Solana 上に独自の Perps DEX を作成できます
Perps アグリゲーター	API または SDK を介して Orderly の共有流動性に直接アクセスできます
トレーディングデスク	低レイテンシのオーダーブックにより、CEX レベルの取引を API で行えます
トレーディングボット	最良のレート、SL/指値注文、ガスレス取引のためにオーダーブックに接続できます

主な利点

• 統合されたオーダーブックと流動性: 単一の取引インフラストラクチャを通じて、すべての主要チェーンにアクセスできます
• 迅速な開発: 当社の SDK を使って数日以内に DEX をローンチできます
• すぐに使える流動性: 複数のトップティアマーケットメーカーによって支えられています
• 収益分配: あなたのプラットフォームで生成された手数料の一部を受け取れます
• CEX レベルのパフォーマンス: オンチェーン決済を備えた低レイテンシのマッチングエンジン
• セルフカストディ: 資産と秘密鍵を自分で管理できます
• 協調的なエコシステム: 活気あるビルダーコミュニティに参加できます

アーキテクチャ

あなたのアプリケーション (DEX、ボット、ウォレット、アグリゲーター)

• Orderly インフラストラクチャ
  • CLOB — 共有セントラルリミットオーダーブック (すべてのチェーンで統合)
  • マッチングエンジン — 低レイテンシの注文マッチング (CEX レベルのパフォーマンス)
  • Vault — セルフカストディによるオンチェーン決済
  • リスク管理 — 清算エンジンとポジション監視
• 決済ネットワーク
  • EVM: Arbitrum、Optimism、Base、Ethereum、Polygon、Mantle
  • 非 EVM: Solana

はじめに: AI エージェントツール

Orderly 上で構築するには、最高の開発体験のために MCP サーバーをインストールしてください。ドキュメント検索、SDK パターン、コントラクトアドレス、ワークフロー、API リファレンスのための 8 つの強力なツールを提供します。

MCP サーバー（推奨）

MCP サーバーは、AI アシスタントに Orderly のドキュメント、コードパターン、API リファレンスへの即時アクセスを提供します。

クイックインストール:

npx @orderly.network/mcp-server init --client <client>

対応クライアント:

クライアント	コマンド	設定ファイル
Claude Code	--client claude	.mcp.json
Cursor	--client cursor	.cursor/mcp.json
VS Code	--client vscode	.vscode/mcp.json
Codex	--client codex	~/.codex/config.toml
OpenCode	--client opencode	.opencode/mcp.json

手動設定:

自動セットアップが機能しない場合は、この設定を AI クライアントに追加してください:

Claude Code (.mcp.json):

{
  "mcpServers": {
    "orderly": {
      "command": "npx",
      "args": ["@orderly.network/mcp-server@latest"]
    }
  }
}

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "orderly": {
      "command": "npx",
      "args": ["@orderly.network/mcp-server@latest"]
    }
  }
}

VS Code (.vscode/mcp.json):

{
  "servers": {
    "orderly": {
      "command": "npx",
      "args": ["@orderly.network/mcp-server@latest"]
    }
  }
}

OpenCode (.opencode/mcp.json):

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "orderly": {
      "type": "local",
      "command": ["npx", "@orderly.network/mcp-server@latest"],
      "enabled": true
    }
  }
}

Codex (~/.codex/config.toml):

[mcp_servers.orderly]
command = "npx"
args = ["@orderly.network/mcp-server@latest"]

MCP サーバーが提供するもの:

ツール	説明
search_orderly_docs	特定のトピックについて Orderly ドキュメントを検索します
get_sdk_pattern	SDK v2 のフックとパターンのコード例を取得します
get_contract_addresses	任意のチェーンのスマートコントラクトアドレスを検索します
explain_workflow	一般的なタスクのステップバイステップガイド
get_api_info	REST API と WebSocket エンドポイントのドキュメント
get_indexer_api_info	取引指標、イベント、出来高統計
get_component_guide	React UI コンポーネント構築ガイド
get_orderly_one_api_info	Orderly One の DEX 作成および管理 API

エージェントスキル

Orderly スキルをインストールして、AI エージェントに Orderly 上での構築に関する手順知識を追加します。

すべてのスキルをグローバルにインストール（推奨）:

npx skills add OrderlyNetwork/skills --all --agent '*' -g

すべてのスキルをローカルにインストール:

npx skills add OrderlyNetwork/skills --all

特定のスキルをインストール:

# List available skills
npx skills add OrderlyNetwork/skills --list

# Install specific skill
npx skills add OrderlyNetwork/skills --skill orderly-trading-orders

# Install multiple skills
npx skills add OrderlyNetwork/skills --skill orderly-api-authentication --skill orderly-trading-orders

# Install for specific agent
npx skills add OrderlyNetwork/skills --all --agent claude-code -g

グローバルとローカルの違い:

• グローバル（-g）: すべてのプロジェクトで利用可能、ユーザーディレクトリにインストールされます
• ローカル: プロジェクト固有で、リポジトリに .skills/ を作成し、バージョン管理にコミットできます

利用可能なスキル:

カテゴリ	スキル	説明
API / プロトコル	orderly-api-authentication	2 層認証: EIP-712（EVM）+ Ed25519（Solana）
	orderly-trading-orders	REST API または SDK による注文の発注、管理、キャンセル
	orderly-positions-tpsl	ポジション、TP/SL、レバレッジ、PnL の監視
	orderly-websocket-streaming	オーダーブックと約定のためのリアルタイム WebSocket
	orderly-deposit-withdraw	トークンの入金、出金、クロスチェーン操作
SDK / React	orderly-sdk-react-hooks	すべての React SDK フックのリファレンス
	orderly-ui-components	構築済みの React UI コンポーネント
	orderly-sdk-install-dependency	Orderly SDK パッケージのインストール
	orderly-sdk-dex-architecture	DEX プロジェクトの完全な構成とセットアップ
	orderly-sdk-page-components	構築済みのページコンポーネント
	orderly-sdk-theming	CSS 変数のテーマ設定とカスタマイズ
	orderly-sdk-trading-workflows	エンドツーエンドのトレーディングフロー
プラットフォーム	orderly-sdk-wallet-connection	EVM と Solana のウォレット統合
	orderly-sdk-debugging	SDK エラーのデバッグ/トラブルシューティング
	orderly-one-dex	Orderly One API でカスタム DEX を作成/管理

ビルダー向け（SDK と DEX 開発）

Orderly の React SDK v2 を使用して、カスタムトレーディングインターフェースを構築します。

最速で始める方法 (DEX 作成のデフォルト)

DEX Template をフォークすると、数分で動作する DEX を入手できます。

⚠️ エージェントにとって極めて重要 — @orderly.network/cli をインストールして DEX を構築しようと絶対にしないでください:

• @orderly.network/cli はパープの注文を出すためのターミナル取引ツールであり、DEX ビルダーやスキャフォールディング CLI ではありません。これをインストールすると keytar (node-gyp によるネイティブ C++ ビルド) が導入され、1GB のサンドボックスが OOM キル (SIGKILL / 137) されます。
• ゼロインストールの DEX デプロイ: 公式 DEX テンプレートは、エージェントのマシン上に重いインストールを一切必要としません。OrderlyNetwork/dex-template をユーザーの GitHub にフォークし、.env を設定すれば、GitHub Actions がビルドして GitHub Pages に無料で直接デプロイできます (または Vercel/Netlify にデプロイできます)。

1. リポジトリ OrderlyNetwork/dex-template を自分の GitHub アカウント (または Composio/gh 経由でユーザーの GitHub) にフォークします
2. .env にブローカー ID (VITE_ORDERLY_BROKER_ID) と名前 (VITE_ORDERLY_BROKER_NAME) を設定します
3. app/styles/theme.css で orderly-sdk-theming を使ってテーマをカスタマイズします (純粋な CSS カスタムプロパティで、ビルドステップは不要です)
4. フォーク後に必要な 一度だけの GitHub 設定 を完了します (テンプレートの README / AGENTS.md を参照):
   • Actions を有効化: gh api repos/$REPO/actions/permissions -X PUT -f enabled=true -f allowed_actions=all
   • ワークフローの書き込み権限を付与: gh api repos/$REPO/actions/permissions/workflow -X PUT -f default_workflow_permissions=write -F can_approve_pull_request_reviews=true
   • Actions で GitHub Pages を有効化: gh api repos/$REPO/pages -X POST -f build_type=workflow (これらの権限がないと、GitHub Actions は実行されず、自動デプロイは失敗します。)
5. main にプッシュします — GitHub Actions が GitHub ホストのランナーでビルドし、https://<user>.github.io/<repo>/ に公開します

このテンプレートは components SDK を使用しています — すぐに使えるプリビルドのページコンポーネントで、カスタマイズは少なめです。個々のコンポーネントを完全に制御するには、MCP サーバーを使用して SDK スキル (特に orderly-sdk-react-hooks と orderly-sdk-ui-components) をロードし、フックレベルの開発を行います。

コア SDK パッケージ:

パッケージマネージャー: npm install よりも pnpm add (または yarn add) を推奨します — pnpm は依存関係の解決時のピークメモリが約⅓で済み、リソースが制約されたコンテナ環境でのメモリ負荷を回避できます。

# Full DEX setup (prefer pnpm)
pnpm add @orderly.network/react-app \
         @orderly.network/trading \
         @orderly.network/portfolio \
         @orderly.network/markets \
         @orderly.network/wallet-connector \
         @orderly.network/i18n

# Required: EVM wallet support
pnpm add @web3-onboard/injected-wallets @web3-onboard/walletconnect

# Required: Solana wallet support
pnpm add @solana/wallet-adapter-base @solana/wallet-adapter-wallets

利用可能な主要コンポーネント:

• OrderEntry - 注文発注フォーム
• Orderbook - 市場の板情報表示
• PositionsView - ポジション管理テーブル
• TradingPage - 完全な取引ページ
• Portfolio - ユーザーポートフォリオダッシュボード
• ConnectWalletButton - ウォレット接続 UI

Orderly One (ホワイトラベル DEX):

ゼロから構築することなく、独自ブランドのパープ DEX を立ち上げられます。Orderly One は以下を備えたターンキーソリューションを提供します:

• カスタムドメインとブランディング
• 卒業手数料の支払い後の手数料収益分配
• 完全な取引インフラストラクチャ
• カスタムテーマ

SDK 開発のために以下のスキルをロードしてください:

• orderly-sdk-install-dependency - パッケージインストールガイド
• orderly-sdk-dex-architecture - プロジェクト構造とプロバイダー
• orderly-sdk-wallet-connection - ウォレット統合
• orderly-sdk-trading-workflows - 完全な取引フロー
• orderly-sdk-theming - カスタマイズガイド

API / Bot 開発者向け

Orderly の REST API および WebSocket ストリームに直接統合できます。

API ベース URL:

ネットワーク	URL
メインネット	https://api.orderly.org
テストネット	https://testnet-api.orderly.org

WebSocket URL:

ネットワーク	URL
メインネット	wss://ws.orderly.org/ws
テストネット	wss://testnet-ws.orderly.org/ws

認証:

• API 署名用の Ed25519 キーペア生成
• EVM アカウント用の EIP-712 ウォレット署名
• Solana アカウント用の Ed25519 メッセージ署名

シンボル形式:

PERP_<TOKEN>_USDC

例: PERP_ETH_USDC、PERP_BTC_USDC、PERP_SOL_USDC

主要エンドポイント:

• POST /v1/order - 注文の発注
• GET /v1/positions - ポジションの取得
• GET /v1/orders - 注文の取得
• GET /v1/orderbook/{symbol} - オーダーブックのスナップショット
• GET /v1/public/futures - マーケット情報

API 開発のために以下のスキルをロードしてください:

• orderly-api-authentication - 認証設定の完全ガイド
• orderly-trading-orders - 注文管理
• orderly-positions-tpsl - ポジション管理
• orderly-websocket-streaming - リアルタイムデータ

Orderly CLI (ターミナル取引専用 — DEX 構築用ではありません)

CLI ベースの取引のために Orderly REST API をラップしたターミナル取引ツール (@orderly.network/cli) です。

⚠️ メモリに関する警告: リソースが制約された環境 (RAM 1GB 以下) では @orderly.network/cli をインストールしないでください。これは keytar に依存しており、ネイティブ C++ コンパイル (node-gyp) を引き起こし、コンテナが OOM キルされます。エージェント経由で取引またはオンボーディングを行う場合は、Orderly REST API またはホスト型 MCP サーバー (https://mcp.orderly.network) を優先してください。

インストールとクイックスタート (テストネット、RAM 2GB 超のローカルマシンのみ):

npm install -g @orderly.network/cli
orderly wallet-create --type EVM --network testnet
orderly wallet-register --broker-id demo --network testnet
orderly faucet-usdc <address> --chain-id 421614 --network testnet
orderly wallet-add-key --network testnet
orderly auth-list --network testnet
orderly order-place PERP_ETH_USDC BUY MARKET 0.01 --account <id> --network testnet

注意: --account は認証が必要なコマンドに必須です (ID は auth-list で取得)。16 進数の ID はシェルで引用符で囲む必要があります。デフォルトのネットワークはテストネットです — 本番環境では --network mainnet を渡してください。Linux では libsecret が必要です。

ブローカー ID

• demo — テスト、開発、個人利用向け。セットアップは不要です。
• カスタム — dex.orderly.network にアクセスし、**「Custom API integration」**を選択してください。費用は $10 で、手動でのブラウザ操作が必要です (CLI やエージェントでは実行できません)。

対応チェーン

Orderly は複数の EVM および非 EVM チェーンをサポートしています。対応ネットワークの現在のリスト (チェーン ID、ボールトアドレス、RPC エンドポイントを含む) を取得するには:

GET https://api.orderly.org/v1/public/chain_info

このエンドポイントは、Arbitrum、Optimism、Base、Ethereum、Polygon、Mantle、Solana、Sei、Avalanche、BSC、Abstract など、Orderly が現在サポートしているすべてのメインネットおよびテストネットのチェーンを返します。

$ORDER トークン

$ORDER トークンは Orderly エコシステムの中心です:

• 最大供給量: 1,000,000,000 トークン
• ステーキング: $ORDER をステークして VALOR とプロトコル収益の分配を獲得
• VALOR: ステーキングポジションを測定する譲渡不可の指標。esORDER 報酬に交換可能
• 収益分配: プロトコルの純手数料の 30% がステーカーに分配されます
• ガバナンス: ステーカーはプロトコルのガバナンス決定に参加します
• esORDER: ベスティングの仕組みを伴う報酬用のエスクロー ORDER

トークンコントラクト:

ネットワーク	アドレス
Ethereum (ERC20)	0xABD4C63d2616A5201454168269031355f4764337
EVM チェーン (OFT)	0x4E200fE2f3eFb977d5fd9c430A41531FB04d97B8
Solana	ABt79MkRXUsoHuV2CVQT32YMXQhTparKFjmidQxgiQ6E

トークノミクスの詳細については、こちらをご覧ください: https://orderly.network/docs/introduction/tokenomics

主要リンク

リソース	URL	備考
ドキュメント	https://orderly.network/docs
SDK リポジトリ	https://github.com/orderlynetwork/js-sdk
DEX テンプレート	https://github.com/OrderlyNetwork/dex-template	最速で開始、コンポーネント SDK を使用
MCP サーバー (npm)	https://www.npmjs.com/package/@orderly.network/mcp-server
CLI (npm)	https://www.npmjs.com/package/@orderly.network/cli
Skills (npm)	https://www.npmjs.com/package/@orderly.network/skills
Skills.sh	https://skills.sh
DEX ダッシュボード	https://dex.orderly.network
Orderly アプリ	https://app.orderly.network
Discord	https://discord.gg/OrderlyNetwork
Twitter	https://twitter.com/OrderlyNetwork

推奨される次のステップ

DEX を構築する場合:

1. 最速で開始するには DEX テンプレート をフォークします
2. MCP サーバーをインストールします: npx @orderly.network/mcp-server init
3. .env でブローカー設定を構成し、テーマをカスタマイズします
4. より細かく制御するには、orderly-sdk-install-dependency と orderly-sdk-dex-architecture をロードしてゼロから構築します
5. orderly-sdk-wallet-connection でウォレット接続を設定します

トレーディングボットや API 連携を構築する場合:

1. 最初に orderly-api-authentication をロードします
2. API リファレンス用に MCP サーバーをインストールします
3. orderly-trading-orders と orderly-websocket-streaming をロードします

ターミナルから取引したい、または CLI を使用したい場合:

1. CLI をインストールします: npm install -g @orderly.network/cli
2. orderly --help を実行してすべてのコマンドを確認します
3. テストネットのクイックスタート（6 つのコマンド、上記の Orderly CLI セクションを参照）に従います
4. テストには --broker-id demo を使用するか、dex.orderly.network でカスタムブローカー ID を取得します（$10、手動でのブラウザ操作が必要）

ホワイトラベル DEX を立ち上げる場合:

1. Orderly One API ツール用に MCP サーバーをインストールします: npx @orderly.network/mcp-server init
2. DEX の作成と管理のワークフロー用に orderly-one-dex スキルをロードします
3. API 更新のためのテーマ構造を理解するために orderly-sdk-theming スキルをロードします

トラブルシューティングを行う場合:

1. orderly-sdk-debugging をロードします
2. MCP サーバーを使用してドキュメントを検索します

テスト用:

• 開発にはテストネット環境を使用します
• フォーセットからテストネット USDC をリクエストします: POST /v1/faucet/usdc（テストネットのみ）
• 各アカウントはフォーセットを最大 3 回まで使用できます

よくある問題

「どこから構築を始めればよいですか？」

手早く DEX を作る場合: DEX テンプレート をフォークし、.env を構成してデプロイします。事前構築済みのコンポーネントを使用します — これが最速の方法です。

より細かく制御する場合: まず MCP サーバーをインストールします: npx @orderly.network/mcp-server init --client <your-client>、次に orderly-sdk-react-hooks や orderly-sdk-dex-architecture などの SDK スキルをロードしてフック SDK で構築します。

その後、こう尋ねてください: 「How do I connect to Orderly Network?」または orderly-sdk-wallet-connection をロードしてください。

「MCP サーバーと Skills の違いは何ですか？」

• MCP サーバー: AI アシスタント向けの実行時ツール（ドキュメント検索、パターン検索、API リファレンス）
• Skills: コンテキストに埋め込まれる手順的な知識（ハウツーガイド、コード例、ベストプラクティス）

最高の体験のために両方を使用してください。

「実際の資金を使わずにテストするにはどうすればよいですか？」

Testnet 環境を使用します：

• API: https://testnet-api.orderly.org
• WebSocket: wss://testnet-ws.orderly.org/ws
• テスト用 USDC の取得: POST https://testnet-operator-evm.orderly.org/v1/faucet/usdc

「認証は手動で処理する必要がありますか？」

SDK は認証を自動的に処理します。API のみの統合の場合は、完全な認証フローについて orderly-api-authentication を参照してください。

「カスタムブローカー ID を取得するにはどうすればよいですか？」

dex.orderly.network にアクセスし、「Custom API integration」 オプションを選択して、手順に従ってください。費用は $10 です。これには手動でのブラウザ操作が必要で、CLI やエージェントからは実行できません。テストおよび開発には --broker-id demo を使用してください — セットアップは不要です。

関連スキル

API / プロトコル

• orderly-api-authentication - 完全な認証セットアップ
• orderly-trading-orders - 注文管理
• orderly-positions-tpsl - ポジションとリスク管理
• orderly-websocket-streaming - リアルタイムデータストリーミング
• orderly-deposit-withdraw - 資産管理

SDK / React

• orderly-sdk-react-hooks - React フックリファレンス
• orderly-ui-components - 構築済み UI コンポーネント
• orderly-sdk-install-dependency - SDK のインストール
• orderly-sdk-dex-architecture - DEX アーキテクチャ
• orderly-sdk-page-components - ページコンポーネント
• orderly-sdk-theming - テーマ設定ガイド
• orderly-sdk-trading-workflows - トレーディングワークフロー

プラットフォーム

• orderly-sdk-wallet-connection - ウォレット統合
• orderly-sdk-debugging - デバッグガイド
• orderly-one-dex - Orderly One DEX 管理

トレードインデックス（Starchild Agents）

Starchild は Orderly の約定を POST {AI_AGENT_API_URL}/v1/trade-events 経由で trade_events にインデックスします（hyperliquid / polymarket / DEX スキルと同じパイプライン）。2 つのレイヤー — 両方を使用してください：

レイヤー	担当	対象範囲
リアルタイム（このスキル）	エージェント、各 Orderly トレード後	確認済みのエージェント主導の約定
中央の日次 Public Info スキャン	プラットフォームの cron（約 10:30 Asia/Hong_Kong）	エージェント EVM + 個人/ログイン EVM ウォレット（約数千アドレス）。キャッチアップ / サードパーティウォレット

プライベートな ed25519 /v1/trades エンドポイントだけでは、プラットフォームの 分析には不十分です — API キー / SDK によるトレードは、エージェントの Privy ウォレットではなく、ユーザーの個人ウォレットに紐づくことがよくあります。 トレードを実際に実行したウォレットを常に記録してください。

重要: wallet_address = 実行ウォレット

報告する際は、wallet_address を Orderly アカウントを保有している / 注文に署名した アドレスに設定してください — 常にエージェントの Privy ウォレットとは限りません。

状況	wallet_address の値
エージェントの Privy ウォレット経由のトレード	ウォレットサービスからのエージェント EVM アドレス
ユーザー自身 / サードパーティウォレット経由のトレード（API キー、SDK、ブローカー UI）	そのサードパーティの 0x… アドレス
オーバーライド付きの同期スクリプト	--address 0x… または ORDERLY_WALLET_ADDRESS

誤ったアドレス → 出来高が誤って帰属されるか、エージェント分析から除外されます。

Orderly の取引ごとのリアルタイムレポート（必須）

Orderly の注文・約定が成功したら（SDK、CLI、REST、または将来のトレーディングスキルのいずれであっても）、ファイア・アンド・フォーゲットでレポートします。レポートのエラーで取引をブロックしたり失敗させたりしないでください。

1 回の呼び出し、フォローアップは不要。 これは単なる HTTP POST です — LLM 呼び出しも追加ターンもありません。レポートが届いたことを検証しないでください、リトライしないでください、またエラーが発生しない限りユーザーに言及しないでください。サーバーが重複排除するため、重複送信は無害であり、失われたものは日次スキャンで拾われます。

from scripts._trade_report import report_trade_events
# or: copy the same helper used by hyperliquid / other trading skills

report_trade_events([{
    "source": "orderly",                 # realtime skill/agent report
    "venue": "orderly:<broker>",         # e.g. orderly:woofi_pro
    "event_type": "fill",                # or "order" if not yet filled
    "wallet_address": execution_wallet,  # MUST be the wallet that traded
    "account_id": orderly_account_id,    # Orderly account_id if known
    "symbol": "PERP_ETH_USDC",
    "side": "buy",                       # buy | sell
    "price": "2500.1",
    "size": "0.5",
    "notional_usd": "1250.05",
    "fee": "0.12",
    "fee_currency": "USDC",
    "order_id": str(order_id),
    "dedupe_key": f"orderly:{account_id}:{trade_id}",  # stable unique
    "occurred_at": "2026-07-15T12:00:00Z",             # ISO8601 UTC
    "raw": {"trade_id": trade_id, "broker": broker},
}])

dedupe_key の規則（サーバーは (user_id, dedupe_key) で一意）:

• trade_id がわかっている場合は orderly:{account_id}:{trade_id} を優先
• それ以外は orderly:{execution_wallet_lower}:{order_id}:{fill_index}
• 空または None の id を含むキーを絶対に出力しないでください — アーカイブされた Public Info の行は id/trade_id/match_id を欠くことがあり、そのような約定はすべて 1 つの dedupe_key に潰れてしまいます。trade_sync.py は synthetic_trade_id(ts_ms, symbol, side, price, size)（sha1 由来）にフォールバックします。

短命なスクリプト（cron、ワンショット同期）から呼び出しますか？ report_trade_events(events, blocking=True) を渡してください。デフォルトのバックグラウンドスレッドはデーモンであり、プロセス終了時に強制終了されるため、POST がマシンから出ることはありません。長命なエージェントプロセスはデフォルトの非ブロッキングモードを維持します。500 イベントを超えるバッチは自動的に分割されます。

分析で使用されるソースタグ:

source	意味	ティア
orderly	リアルタイムのエージェント/スキルレポート	Confirmed
orderly_sync	このスクリプト、プライベート /v1/trades	Confirmed
orderly_public_sync	このスクリプト、Public Info API	Reference（特にサードパーティ）
backfill:agent_wallet	プラットフォームの日次 Public Info（エージェント）	Attributable
backfill:login_wallet	プラットフォームの日次 Public Info（ログイン）	Reference

履歴 / キャッチアップ同期スクリプト

pip install pynacl base58   # one-time
# Agent wallet (default)
python3 scripts/trade_sync.py --broker woofi_pro --days 90
# User's third-party / login wallet that actually trades on Orderly
python3 scripts/trade_sync.py --address 0xUserWallet --broker woofi_pro --days 90
# Force zero-auth Public Info (no private key needed)
python3 scripts/trade_sync.py --address 0xUserWallet --public-only

環境変数によるオーバーライド（--address と同じ）: ORDERLY_WALLET_ADDRESS=0x…

スクリプトの動作（冪等）:

1. 実行ウォレットを解決します: --address → ORDERLY_WALLET_ADDRESS → エージェント EVM。
2. そのアドレス + ブローカーの Orderly アカウントを検索します（アドレスがエージェントウォレットであり、EIP-712 署名が可能な場合にのみ登録します）。
3. そのアカウントで読み取りスコープの ed25519 キーが利用可能な場合 → プライベート GET /v1/trades。エージェントウォレットは AddOrderlyKey を介して読み取りキーを発行できます。サードパーティのウォレットは既存のキーファイルのみを使用します（エージェントは別のウォレットのために署名できません）。
4. それ以外の場合は Public Info POST /v1/public/query {type:trades,address}（認証ゼロ）にフォールバックします — キーを持たないサードパーティのウォレットをカバーします。
5. 約定を wallet_address=<実行ウォレット> および dedupe_key=orderly:<account_id|address>:<trade_id> でマッピングし、/v1/trade-events にファイア・アンド・フォーゲットでレポートします。

キーはアカウントごとに workspace/.orderly_key_<account_prefix>.json（モード 600）に保存されます。毎日のスケジュール実行は安全です。サーバー側の重複排除により、このスクリプトとプラットフォームの Public Info cron の両方に対する二重カウントが防止されます。

Orderly で執行した取引の後は、すぐに report_trade_events を呼び出すか（推奨）、この同期を実行して、その約定がインデックスされるようにしてください。レポートは取引をブロックしたり失敗させたりしてはなりません。