bankr

Name: bankr
Author: bankrbot

github.com/bankrbotその他1.2k1.1k 回インストール5 日前に更新

リポジトリ

bankr について

bankrは、自然言語のプロンプトやウォレットAPIで暗号資産取引やDeFi操作を行うスキルです。Bankr CLIまたはREST APIを使うエージェントや開発者向けで、同期型のウォレットAPIと非同期のエージェントジョブを備えます。

主な機能

01自然言語による暗号資産操作
02ポートフォリオ照会と送金
03トランザクションの署名と送信
04スレッド対応の非同期プロンプトジョブ
05CLIとREST APIでの利用

活用シーン

01エージェントによるトークン残高や価格の確認
02ウォレット送金やトランザクションの送信
03プロンプトスレッドでの操作の継続

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/bankrbot/skills --skill bankr

インストール後、Claude Code で/bankrを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

catalog.json

references/

api-workflow.md

arbitrary-transaction.md

automation.md

error-handling.md

files.md

hyperliquid.md

leverage-trading.md

llm-gateway.md

market-research.md

nft-operations.md

polymarket.md

portfolio.md

projects.md

safety.md

sign-submit-api.md

token-deployment.md

token-trading.md

tokenized-stocks.md

transfers.md

x402-cloud.md

詳細

Bankr

自然言語を使って、暗号資産の取引や DeFi 操作を実行できます。統合方法は 2 つあります。

Bankr CLI（推奨） — @bankr/cli をインストールして、必要な機能がそろったターミナル環境を利用します
REST API — あらゆる言語やツールから https://api.bankr.bot を直接呼び出します

どちらも同じ API キーを使用します。API には 2 つのレイヤーがあります。

Wallet API（/wallet/*） — ポートフォリオ、送金、署名、トランザクション送信のための、直接実行される同期エンドポイントです
Agent API（/agent/*） — 自然言語での操作に対応する、AI 搭載の非同期プロンプトエンドポイントです

API キーの取得

どちらの方法を使う場合も、Bankr API キーが必要です。取得方法は 2 つあります。

オプション A：ヘッドレスのメールログイン（エージェントに推奨）

2 段階のフローです。OTP を送信し、その後、認証してセットアップを完了します。ユーザーの設定を確認するプロンプトを含む、ガイド付きフロー全体については、以下の「初回セットアップ」を参照してください。

# Step 1 — send OTP to email
bankr login email [email protected]

# Step 2 — verify OTP and generate API key (options based on user preferences)
bankr login email [email protected] --code 123456 --key-name "My Agent"

これにより、ウォレットが作成され、利用規約に同意し、API キーが生成されます。ブラウザーは不要です。ステップ 2 の完了時に、ユーザーに代わって利用規約に同意します（ヘッドレスログインでは --accept-terms が暗黙的に指定されます）。そのため、このコマンドを実行する前にリンクを共有し、ログインすると利用規約に同意することになるとユーザーに伝えてください。以下の「初回セットアップ」も参照してください。新しいキーには、bankr.bot/api-keys の作成フォームと同じデフォルト設定が適用されます。Wallet API、Agent API、Token Launch は有効、読み書き可能、LLM ゲートウェイは無効です。ステップ 2 を実行する前に、ユーザーに変更する設定（--no-wallet-api、--no-agent-api、--no-token-launch、--read-only、--llm）と、希望するキー名を確認してください。

MFA が有効なアカウントでは、ブラウザーでの操作が必要です。 MFA が有効な場合、API キーの発行にはパスキーによる追加認証が必要ですが、パスキーはターミナルでは使用できません。ステップ 2 では承認リンク（https://bankr.bot/mfa/confirm/<token>）が表示され、対話形式の場合はリンクが開きます。ユーザーがそこでパスキーを使って認証するまで最大 5 分間待機し、その後続行します。リンクをユーザーに表示して、完了するまで待ってください。ステップ 2 を再実行しないでください。期限切れになると、CLI は MFA_STEP_UP_REQUIRED の案内を表示して終了します。その場合はオプション B に切り替え、Bankr Terminal でキーを作成してから bankr login --api-key bk_... を実行してください。@bankr/cli 0.3.38 以降が必要です（bankr update）。それより古いバージョンでは、MFA が有効なアカウントでステップ 2 が直ちに失敗します。

ステップ 2 は 1 回限りです。 OTP は認証時に消費されます。@bankr/cli 0.3.39 以降では、接続切断後やゲートウェイの 5xx エラー後に、CLI が OTP 認証、ウォレット、利用規約の各ステップを自動的に再試行します（無効なコードや 429 は再試行されません）。そのため、同じコードを使ってステップ 2 を再実行しないでください。完全に失敗した場合は、ステップ 1 からやり直して新しいコードを取得してください。

オプション B：Bankr Terminal

bankr.bot/api-keys にアクセスします
サインアップ／サインイン — メールアドレスと、そこに送信されたワンタイムパスコード（OTP）を入力します
API キーを生成 — Wallet & Agent API へのアクセスを有効にしてキーを作成します（キーは bk_... で始まります）

どちらの方法でも、EVM ウォレット（Base、Ethereum、Polygon、Unichain）と Solana ウォレットが自動的に作成されます。手動でウォレットを設定する必要はありません。

オプション 1：Bankr CLI（推奨）

インストール

bun install -g @bankr/cli

または、npm を使う場合：

npm install -g @bankr/cli

初回セットアップ

ヘッドレスメールログイン（エージェント向けの推奨方法）

ユーザーからメールでログインするよう求められたら、この手順を案内してください。ユーザーの Bankr アカウントで MFA が有効になっている場合、ステップ 2 ではブラウザーでの承認が追加されます。CLI は bankr.bot/mfa/confirm/... リンクを表示し、ユーザーがそこでパスキーを使って認証するまで（最長 5 分）待機します。リンクが表示されたらすぐにユーザーに知らせ、コマンドは実行したままにしてください。承認されると、CLI は自動的に処理を続行します。期限内に承認できない場合は、代わりに下記の「既存の API キーでログイン」を使用してください。

ステップ 1 — 確認コードを送信

bankr login email <user-email>

ステップ 2 — OTP コードとすべての設定を、1 回のメッセージでユーザーに尋ねてください。 これにより、不要なやり取りを避けられます。次の項目を尋ねてください。

OTP コード — メールで受け取ったコード
利用規約（必須） — 利用規約へのリンクを共有し、このログインを完了すると、ユーザーは Bankr の利用規約に同意することになりますと明確に伝えてください。ヘッドレスログインではログインの一環として利用規約に同意するため、ユーザーからの許可のみが必要です。次のように伝えてください。「このログインを完了すると、Bankr の利用規約（https://bankr.bot/terms）に同意したことになります。続行するにはコードを送信してください。同意しない場合は、その旨を伝えてください。ここで中止します。」**ユーザーが同意しない場合は中止し、ステップ 2 を実行しないでください。**
必要な API はどれですか？
- Wallet API — デフォルトで有効です。無効にするには --no-wallet-api を使用します
- Agent API — デフォルトで有効です（AI によるプロンプトと自然言語での操作）。無効にするには --no-agent-api を使用します
- Token Launch — デフォルトで有効です。無効にするには --no-token-launch を使用します
- 読み取り専用ですか？ — 新しいキーはデフォルトで読み書き可能です。取引を一切行わない調査用または監視用のキーにするには、--read-only を追加します
LLM ゲートウェイへのアクセスを有効にしますか？（--llm）— llm.bankr.bot のマルチモデル API（現在はベータテスターのみ利用可能）。ユーザーが必要としていない場合は省略してください。
キー名は何にしますか？（--key-name）— API キーの表示名（例：「My Agent」、「Trading Bot」）

ステップ 3 — ユーザーの選択に基づいてステップ 2 のコマンドを作成し、実行します。 ユーザーが利用規約への同意を拒否した場合、または回答していない場合は、実行しないでください。必要に応じて、もう一度尋ねてください。ステップ 2 を実行すると、ユーザーに代わって利用規約に同意することになります。

# Default key: wallet + agent + token launch, read-write (AI can execute transactions)
bankr login email <user-email> --code <otp> --key-name "Trading Agent"

# Same, plus LLM gateway access
bankr login email <user-email> --code <otp> --key-name "My Agent" --llm

# Research agent: read-only (prices, balances, research — no transactions), no token launch
bankr login email <user-email> --code <otp> --key-name "Research Agent" --read-only --no-token-launch

# Wallet API only (no AI prompts): direct /wallet/* calls from your own code
bankr login email <user-email> --code <otp> --key-name "Wallet Client" --no-agent-api --no-token-launch

# LLM-only (no wallet, no token launch)
bankr login email <user-email> --code <otp> --key-name "LLM Client" --no-wallet-api --no-token-launch --llm

ログインオプションのリファレンス

オプション	説明
`--code <otp>`	メールで受信した OTP コード（ステップ 2）
`--accept-terms`	確認を求めずに利用規約に同意します。ヘッドレスログイン（`--code` / `--ni`）では自動的に適用されます（@bankr/cli 0.3.39+）。この場合は古いスクリプトとの互換性のために残されており、何も行いません。0.3.38 以前では、新規アカウントでこのオプションを指定しないとステップ 2 が失敗します
`--key-name <name>`	API キーの表示名（例：「My Agent」）。省略すると確認が求められます。ヘッドレス実行では `CLI-<date>-<time>` がデフォルトになります
`--no-wallet-api`	Wallet API を無効にします（デフォルトでは有効）
`--no-agent-api`	Agent API を無効にします（デフォルトでは有効）
`--read-only`	キーを読み取り操作のみに制限します（新しいキーはデフォルトで読み書き可能です）。`--read-write` とは同時に指定できません
`--read-write`	トランザクションを許可します。新しいキーはすでに読み書き可能なため、これがデフォルトです
`--no-token-launch`	Token Launch API を無効にします（デフォルトでは有効）
`--llm`	LLM ゲートウェイへのアクセスを有効にします（`llm.bankr.bot` のマルチモデル API）。現在はベータテスターに限られています
`--allowed-ips <ips>`	API キーの IP/CIDR 許可リスト（カンマ区切り、例：`1.2.3.4,10.0.0.0/24`）
`--allowed-recipients <addresses>`	キーによる送信を許可する EVM/Solana アドレス（カンマ区切り。`0x` プレフィックスで自動判別されます）

新しいキーのデフォルト（フラグを指定しない場合）：

フラグ	デフォルト	変更方法
`walletApiEnabled`	有効	`--no-wallet-api`
`agentApiEnabled`	有効	`--no-agent-api`
`tokenLaunchApiEnabled`	有効	`--no-token-launch`
`llmGatewayEnabled`	無効	`--llm`
`readOnly`	無効	`--read-only`

これらのデフォルトと --no-agent-api / --read-only フラグには @bankr/cli 0.3.37+ が必要です。古いバージョンでは、メールログインキーの Agent API は無効になり、オプトアウト用のフラグもありません（bankr update を実行するか、bankr.bot/api-keys でキーを修正してください）。ログイン後に表示される Features: 行で、キーに実際に適用された設定を確認できます。bankr login siwe は 1 点異なります。キーは読み取り専用で作成され、--read-write で切り替えます（こちらでも --no-agent-api は機能します）。

コマンドラインで指定しなかったオプションは、CLI が対話形式で確認します。そのため、必要に応じてヘッドレス方式と対話方式を組み合わせられます。

既存の API キーでログインする

ユーザーがすでに API キーを持っている場合（ブラウザーでの承認期限が切れた、または完了できなかった MFA 対応アカウントでの代替手段でもあります）：

bankr login --api-key bk_YOUR_KEY_HERE

Bankr Terminal でキーを作成する必要がある場合：

bankr login --url を実行します — ターミナルの URL が表示されます
URL をユーザーに提示し、bk_... キーを生成するよう依頼します
bankr login --api-key bk_THE_KEY を実行します

LLM ゲートウェイ専用キー（任意）

LLM ゲートウェイキーが API キーと異なる場合は、ログイン時に --llm-key を指定するか、後から bankr config set llmKey YOUR_LLM_KEY を実行します。設定されていない場合、両方に API キーが使用されます。詳しくは references/llm-gateway.md を参照してください。

セットアップを確認する

bankr whoami
bankr wallet portfolio
bankr agent prompt "What is my balance?"

オプション 2：REST API（直接利用）

CLI のインストールは不要です。curl、fetch、または任意の HTTP クライアントで API を直接呼び出します。

機械可読仕様（OpenAPI）

公開 API の仕様は OpenAPI 3.0 ドキュメントとして公開されており、エージェントやコードジェネレーターが直接利用できるよう、raw ファイルとして提供されています。

https://docs.bankr.bot/openapi/api.yaml

リンクが変更された場合は、Agent API overview に最新のリンクが掲載されています。

API キーで利用できるすべての機能を網羅しています。/agent/* のプロンプトとジョブ、/wallet/* エンドポイント、トークン検索と受取人の解決、トークンのローンチ、クリエイター手数料、プロジェクト（エージェントプロフィール）ページ、ファイルストレージ、Bankr Club、LLM Gateway クレジット、x402 Cloud および Webhooks のデプロイエンドポイントが含まれます。各操作には、必要なキーのフラグと、リクエストを拒否する可能性のあるセキュリティ設定が記載されています。

ルートやペイロードの形式を推測せず、仕様を取得してください。仕様はリクエスト／レスポンスのスキーマを示す正式な説明であり、同期の合間にもこのスキルより先に更新されます。説明ドキュメントは docs.bankr.bot にあります。

認証

すべてのリクエストに X-API-Key ヘッダーが必要です。

curl -X POST "https://api.bankr.bot/agent/prompt" \
  -H "X-API-Key: bk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "What is my ETH balance?"}'

簡単な例：送信 → ポーリング → 完了

# 1. Submit a prompt — returns a job ID
JOB=$(curl -s -X POST "https://api.bankr.bot/agent/prompt" \
  -H "X-API-Key: $BANKR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "What is my ETH balance?"}')
JOB_ID=$(echo "$JOB" | jq -r '.jobId')

# 2. Poll until terminal status
while true; do
  RESULT=$(curl -s "https://api.bankr.bot/agent/job/$JOB_ID" \
    -H "X-API-Key: $BANKR_API_KEY")
  STATUS=$(echo "$RESULT" | jq -r '.status')
  [ "$STATUS" = "completed" ] || [ "$STATUS" = "failed" ] || [ "$STATUS" = "cancelled" ] && break
  sleep 2
done

# 3. Read the response
echo "$RESULT" | jq -r '.response'

会話スレッド

すべてのプロンプト応答には threadId が含まれます。会話を続けるには、これを渡してください。

# Start — the response includes a threadId
curl -X POST "https://api.bankr.bot/agent/prompt" \
  -H "X-API-Key: $BANKR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "What is the price of ETH?"}'
# → {"jobId": "job_abc", "threadId": "thr_XYZ", ...}

# Continue — pass threadId to maintain context
curl -X POST "https://api.bankr.bot/agent/prompt" \
  -H "X-API-Key: $BANKR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "And what about SOL?", "threadId": "thr_XYZ"}'

新しい会話を開始するには、threadId を省略します。CLI での同等のコマンドは bankr agent prompt --continue（最後のスレッドを再利用）または bankr agent prompt --thread <id> です。

API エンドポイントの概要

ウォレット API（`/wallet/*`）— 直接エンドポイント（同期）

エンドポイント	メソッド	認証	説明
`/wallet/me`	GET	読み取り	ウォレット情報（アドレス、チェーン）
`/wallet/portfolio`	GET	読み取り	ポートフォリオ残高。段階的な読み込みには `?include=pnl,nfts` を指定できます
`/wallet/swap-quote`	POST	読み取り	スワップを実行せずに見積もります（同一チェーンの EVM、クロスチェーン、Solana）
`/wallet/swap`	POST	書き込み	スワップを実行します。同一チェーンの EVM、クロスチェーン、または Solana の任意の経路に対応します（出力はウォレットに戻ります）
`/wallet/transfer`	POST	書き込み	トークンを送金します（マルチチェーン対応。`allowedRecipients` による制限を適用できます）
`/wallet/sign`	POST	書き込み	メッセージ、型付きデータ、またはトランザクションに署名します
`/wallet/submit`	POST	書き込み	生のトランザクションをチェーンに送信します

読み取りエンドポイント（/wallet/me、/wallet/portfolio）— ウォレットを持つ有効な API キーであれば利用できます
スワップ見積もり（/wallet/swap-quote）— 見積もりは読み取り操作のため、読み取り専用 API キーも使用できます。ただし、API キーを使う場合は walletApiEnabled が必要です
書き込みエンドポイント（/wallet/swap、/wallet/transfer、/wallet/sign、/wallet/submit）— walletApiEnabled が必要で、読み取り専用キーは拒否されます。/wallet/transfer では allowedRecipients も適用されますが、/wallet/swap では適用されません（出力は自身のウォレットに戻ります）。/wallet/submit では、ウォレットのセキュリティ設定も検査されます。ネイティブの value に対する支出上限、value > 0 の場合の to に対する許可済み受取人、任意コントラクト呼び出しの切り替えが対象です。403 が返る場合、機械可読な errorCode を含むこともあれば（ガードによる上限・受取人・価格設定の拒否）、コードを含まずプレーンなメッセージのみの場合もあります（ウォレットの一時停止、任意呼び出しの無効化）。どちらの形式にも対応してください（references/sign-submit-api.md を参照）
すべてのエンドポイントで IP 許可リストが適用されます

受取人とユーザーの検索ヘルパー（公開、認証不要）

エンドポイント	メソッド	説明
`/addresses/resolve?value=<recipient>&type=<address\|ens\|twitter\|farcaster>`	GET	受取人（0x アドレス、ENS 形式の名前 `.eth`／`.base.eth`／`.cb.id`、またはソーシャルハンドル）を 0x アドレスに解決します。`bankr wallet transfer --to` が ENS 入力に対応するために使用します。
`/users/search?...`	GET	Twitter または Farcaster のユーザー名で Bankr ユーザーを検索します。

従来のエイリアス /public/resolve-recipient と /public/search-users は削除されました。代わりに、構造化された /addresses/resolve と /users/search エンドポイントを使用してください。

Agent API（`/agent/*`）— AI 搭載エンドポイント（非同期）

エンドポイント	メソッド	説明
`/agent/prompt`	POST	プロンプトを送信します（非同期、ジョブ ID を返します）
`/agent/job/{jobId}`	GET	ジョブのステータスと結果を確認します
`/agent/job/{jobId}/cancel`	POST	実行中のジョブをキャンセルします

パブリックエンドポイント（認証不要）

エンドポイント	メソッド	説明
`/token-launches`	GET	最近ローンチされたトークンの一覧を取得します（キャッシュ済み、公開）
`/token-launches/quote-tokens?chain=<chain>`	GET	そのチェーンでローンチされるトークンとペアにできるトークンを提示します。最初に WETH、次にトークン化された株式（Robinhood Chain／Base）、続いて Base の許可リストを表示します。各エントリーには、それを選択する deploy フィールドが記載されています

廃止された旧エンドポイント

以下の /agent/* エンドポイントは削除されました。代わりに /wallet/* の同等エンドポイントを使用してください。

廃止されたエンドポイント	代わりに使用
`GET /agent/me`	`GET /wallet/me`
`GET /agent/balances`	`GET /wallet/portfolio`
`POST /agent/sign`	`POST /wallet/sign`
`POST /agent/submit`	`POST /wallet/submit`

API の詳細（リクエスト／レスポンスのスキーマ、ジョブの状態、詳細データ、ポーリング戦略）については、以下を参照してください。

リファレンス： references/api-workflow.md | references/sign-submit-api.md

CLI コマンドリファレンス（v0.3.x）

@bankr/cli 0.2+ では、コマンドが wallet、agent、tokens の 3 つの名前空間に分類されています。以前のフラットなコマンド（balances、prompt、status など）も、非推奨のエイリアスとして引き続き使用できます。

`bankr wallet` — ウォレット操作

コマンド	説明
`bankr wallet`	ウォレット情報を表示します（デフォルト：whoami）
`bankr wallet portfolio`	すべてのチェーンのポートフォリオ残高を表示します（デフォルトでは $1 未満のトークンを非表示）
`bankr wallet portfolio --pnl`	損益データを含めます
`bankr wallet portfolio --nfts`	NFT 保有状況を含めます
`bankr wallet portfolio --all`	PnL と NFT の両方を含めます
`bankr wallet portfolio --chain <chains>`	チェーンで絞り込みます：base、polygon、mainnet、unichain、arbitrum、bnb、worldchain、robinhood、arc、solana（カンマ区切り）
`bankr wallet portfolio --json`	生の JSON を出力します
`bankr wallet transfer --to <recipient> --token <symbol> --amount <amount>`	トークンを送金します。`--to` は 0x アドレスまたは ENS 形式の名前（`.eth`、`.base.eth`、`.cb.id`）を受け付け、`--token` はシンボルをコントラクトに解決します。ソーシャルハンドルは AI エージェント経由でのみ使用できます。
`bankr wallet transfer --to vitalik.eth --token USDC --amount 50 --chain base`	明示的なチェーンを指定した ENS 受取人
`bankr wallet swap --from <symbol/addr> --to <symbol/addr> --amount <amount>`	単一の EVM チェーン上でトークンをスワップします（同一チェーン）。シンボルをコントラクトに解決します。`--from`／`--to`／`--amount` は必須です。`--chain` のデフォルトは `base` です。Solana はサポートされていません（クロスチェーンおよび Solana のスワップには Wallet API またはエージェントを使用してください）。
`bankr wallet swap --from ETH --to USDC --amount 0.1 --chain base --quote-only`	スワップを実行せず、スワップ見積もり（支払額／受取額／最低受取額）を表示します
`bankr wallet sign`	メッセージ／型付きデータ／トランザクションに署名します
`bankr wallet submit`	生のトランザクションを送信します

`bankr agent` — AI エージェント操作

コマンド	説明
`bankr agent prompt <text>`	Bankr AI エージェントにプロンプトを送信します
`bankr agent prompt <text> --model <id>`	Max Mode — このプロンプトを特定のゲートウェイモデルで実行し、LLM クレジットから料金が差し引かれます（`-m` も使用できます）
`bankr agent prompt --continue <text>`	直近の会話スレッドを続行します
`bankr agent prompt --thread <id> <text>`	指定した会話スレッドを続行します
`bankr agent status <jobId>`	実行中のジョブのステータスを確認します
`bankr agent cancel <jobId>`	実行中のジョブをキャンセルします
`bankr agent skills`	Bankr AI エージェントのすべてのスキルと例を表示します

`bankr project` — プロジェクトページ

公開プロジェクトページを作成、管理します（bankr.bot/terminal/projects に掲載されるページです）。

コマンド	説明
`bankr project`	プロジェクトページを表示します（生の出力を表示するには `--json` を指定します）
`bankr project create`	プロジェクトページを作成します（対話形式、または `--name/--description/--token/--image/--website` を指定します）
`bankr project update`	フィールドを更新します（ウォレットが複数のプロジェクトを保持している場合は `--slug` が必須です）
`bankr project add-update`	タイムラインの更新を投稿します（`--title`、`--content`、`--slug`）
`bankr project delete`	プロジェクトページを削除します（`--slug`）

ウォレットは複数のプロジェクトページを保持できます。--slug を指定すると、対象を区別できます。

REST インターフェースでは、/agent/profile、/agent-profiles、JSON フィールドなど、一貫して「profile」という語が使われています。スラッグで指定するバリエーションや multi=true のバリエーションを含め、references/projects.md を参照してください。

`bankr tokens` — トークンの検索

コマンド	説明
`bankr tokens search <query>`	名前またはシンボルでトークンを検索します
`bankr tokens info <symbol-or-address>`	トークンの詳細情報を取得します

`bankr files` — ファイルストレージ

コマンド	説明
`bankr files ls [--folder <path>]`	ファイルを一覧表示します。フォルダーを指定して対象を絞ることもできます
`bankr files upload <file> [--folder <path>]`	ローカルファイルをアップロードします
`bankr files download <fileId>`	ダウンロード URL を取得します
`bankr files cat <fileId>`	ファイルの内容を標準出力に表示します（またはローカルに保存します）
`bankr files edit <fileId> --find <text> --replace <text>`	ファイル内のテキストを検索して置換します（すべての出現箇所を対象にするには `--all` を指定します）
`bankr files write <fileId> [--from <path>]`	ローカルファイルまたは標準入力からテキストの内容を上書きします
`bankr files search <query> [--folder <path>] [--limit <n>]`	ファイル名、拡張子、説明で検索します
`bankr files mkdir <name> [--parent <path>]`	フォルダーを作成します
`bankr files rm <fileId>`	ファイルを削除します（ソフト削除のため、24時間以内なら復元できます）
`bankr files storage`	ストレージの使用量と上限を表示します

`bankr club` — Bankr Club メンバーシップ

CLI から Bankr Club のサブスクリプションを管理します（ステータス確認、登録、キャンセル）。USDC（デフォルト）、BNKR、ETH、または任意の Base ERC-20 で支払えます。USDC／BNKR 以外のトークンは、チェックアウト時に USDC にスワップされます。

コマンド	説明
`bankr club`	メンバーシップのステータスを表示します（デフォルト。`status` と同じです）
`bankr club status`	プラン、更新日、1 日あたりのメッセージ数を表示します
`bankr club signup`	サブスクリプションに登録します（月額、デフォルトは USDC）
`bankr club signup --yearly`	年額プランに登録します（$198 — 年間約 $42 お得です）
`bankr club signup --token <symbol-or-addr>`	`USDC`（デフォルト）、`BNKR`、`ETH`、または 0x で始まる任意の Base ERC-20 で支払います
`bankr club signup -y`	確認プロンプトをスキップします
`bankr club cancel`	サブスクリプションをキャンセルします（期間終了まではアクセスできます）

料金は月額 $20、または年額 $198 相当の USD です。実際のオンチェーンでの支払額は、見積もり時点での選択したトークンの価格によって異なります。--token フラグは CLI 0.3.4 で追加されました。それ以前のバージョンでは USDC のみをサポートしています。

Club によって利用可能になる機能（それ以外はすべて、加入しなくても利用できます）：

特典	Standard	Bankr Club
スワップ手数料	0.65%	0.15%
ターミナルメッセージ	1 日 5 件	無制限
エージェント API リクエスト	1 日 100 件	1 日 1,000 件
同時実行可能な定期エージェントコマンド自動化	—	最大 20 件
トークンのローンチ	24 時間のローリング期間あたり 3 回	24 時間のローリング期間あたり 3 回 — Club によって上限は引き上げられません
ファイルストレージ	1 GB（1 ファイルあたり 10 MB）	10 GB（1 ファイルあたり 50 MB）
月間ファイルダウンロード	10 GB	100 GB
モデルルーティング	Standard	最上位モデル
ブラウザーセッション、高度なリサーチ（Bankr スコア、PnL と取引量の分析、ウェブ検索、ソーシャルセンチメント）	—	含まれます

ローンチ上限だけは、意図的に特典の内容が変わらない項目です。すべての Bankr ウォレット（Standard、Club、パートナー組織、プロビジョニング済みパートナー）で、24 時間のローリング期間あたりにカウントされるローンチ試行回数は同じ 3 回です。トークンのデプロイを参照してください。

Max Mode はサブスクリプションの代替手段です。LLM クレジットからリクエストごとに支払うことで、ターミナルメッセージが無制限になり、外部／接続済みウォレットでも利用できます。Club のチェックアウトでは外部／接続済みウォレットを利用できず、埋め込み型 Bankr ウォレットが必要です。Agent API では、Club に加入していない Max Mode の利用者には、引き続き 1 日 100 件のリクエスト上限が適用されます。旧 Bankr Club NFT を保有していても、メンバーシップは付与されません。この NFT は最初の 1,000 人の加入者に贈られた記念トークンです。

月額から年額へのアップグレード：月額プランのメンバーは、エージェントに依頼することで年額プランにアップグレードできます（例：「年額プランにアップグレードして」）。年額料金の全額が請求され、新しい 365 日間の期間は残りの月額期間に加算されるため、支払い済みの期間が失われることはありません。年額から月額へのダウングレードと、年額プランの再登録には対応していません。

認証と設定のコマンド

コマンド	説明
`bankr login`	Bankr API で認証します（対話型メニュー）
`bankr login email <address>`	メールアドレスに OTP を送信します（ヘッドレス実行のステップ 1）
`bankr login email <address> --code <otp> [options]`	OTP を検証してセットアップを完了します（ヘッドレス実行のステップ 2）
`bankr login --api-key <key>`	既存の API キーを直接使ってログインします
`bankr login --api-key <key> --llm-key <key>`	LLM ゲートウェイ用の別のキーを指定してログインします
`bankr login --url`	API キーを生成するための Bankr Terminal URL を表示します
`bankr logout`	保存済みの認証情報を消去します
`bankr whoami`	現在の認証情報を表示します
`bankr config get [key]`	設定値を取得します
`bankr config set <key> <value>`	設定値を指定します
`bankr --config <path> <command>`	カスタム設定ファイルのパスを使用します

有効な設定キー：apiKey、apiUrl、llmKey、llmUrl

デフォルトの設定ファイルの場所：~/.bankr/config.json。--config または BANKR_CONFIG 環境変数で上書きできます。

非対話モード

ヘッドレス環境（CI パイプライン、Docker コンテナ、cron ジョブなど）では、グローバルフラグ --not-interactive（エイリアス --ni）を渡すか、BANKR_NOT_INTERACTIVE=1 を設定します。どちらの形式も、サブコマンドの前後どちらに指定しても機能します。

このフラグを指定すると、すべての確認プロンプトで --yes が暗黙的に有効になり、必須プロンプトでコマンドが停止する場合は、すぐに終了します（終了コード 1、明確なエラーを表示）。自動化されたスクリプトでの実行をユーザーが求めた場合は、必ず使用してください。

コマンド	--ni が設定されている場合に必要なヘッドレスフラグ
`bankr login`	`--api-key <key>`、`login siwe --private-key <key>`、または `login email <addr> [--code <otp>]`（MFA が有効なアカウントでは、手順 2 でパスキーの承認リンクが表示され、最大 5 分間待機します。`--ni` ではブラウザーは開きません）
`bankr launch`	`--name <name>`（その他のフィールドは空のままです。チェーンとプールのクオートトークンを選択するには `--chain` と `--quote <symbol\|address>` を追加します。指定しない場合は WETH です）
`bankr fees claim-wallet`	`--all`（および `--private-key` または `BANKR_PRIVATE_KEY`）
`bankr agent`	プロンプト引数、またはパイプで渡した stdin

読み取り専用コマンド（whoami、wallet portfolio、tokens、agent status など）はプロンプトを表示しません。そのため、--ni を指定しても問題ありませんが、不要です。

例：

# Cron — claim creator fees nightly
BANKR_PRIVATE_KEY=0x... bankr --ni fees claim-wallet --all

# CI — programmatic token launch (simulate, no broadcast)
bankr --ni launch --name MyToken --symbol MTK --simulate

# Pipeline — agent prompt from stdin
echo "summarize today's trades" | bankr --ni agent prompt

非推奨のエイリアス

従来のフラットなコマンドも引き続き動作しますが、名前空間付きのバージョンを優先してください。

非推奨	使用するコマンド
`bankr prompt`	`bankr agent`
`bankr status`	`bankr agent status`
`bankr cancel`	`bankr agent cancel`
`bankr balances`	`bankr wallet portfolio`
`bankr profile`	`bankr project`
`bankr agent profile`	`bankr project`
`bankr sign`	`bankr wallet sign`
`bankr submit`	`bankr wallet submit`
`bankr skills`	`bankr agent skills`

環境変数

変数	説明
`BANKR_API_KEY`	API キー（保存済みのキーを上書きします）
`BANKR_API_URL`	API URL（デフォルト：`https://api.bankr.bot`）
`BANKR_LLM_KEY`	LLM ゲートウェイキー（設定されていない場合は `BANKR_API_KEY` にフォールバックします）
`BANKR_LLM_URL`	LLM ゲートウェイ URL（デフォルト：`https://llm.bankr.bot`）
`BANKR_NOT_INTERACTIVE`	`1` に設定すると、非対話モードをグローバルに有効にします（すべての呼び出しで `--ni` / `--not-interactive` を渡すのと同じです）

環境変数は設定ファイルの値を上書きします。設定ファイルの値はデフォルト値を上書きします。

LLM ゲートウェイのコマンド

コマンド	説明
`bankr llm models`	利用可能な LLM モデルを一覧表示します
`bankr llm credits`	クレジット残高を確認します
`bankr llm credits add <amount> [--token <addr>] [-y]`	ウォレットから LLM クレジットをチャージします
`bankr llm credits auto [--enable/--disable] [--amount] [--threshold] [--tokens]`	自動チャージを表示または設定します
`bankr llm setup openclaw [--install]`	OpenClaw の設定を生成またはインストールします
`bankr llm setup opencode [--install]`	OpenCode の設定を生成またはインストールします
`bankr llm setup claude`	Claude Code の環境設定を表示します
`bankr llm setup cursor`	Cursor IDE の設定手順を表示します
`bankr llm claude [args...]`	Bankr LLM Gateway 経由で Claude Code を起動します
`bankr claude [args...]`	`bankr llm claude` のトップレベルエイリアスです
`bankr llm opencode [args...]`	Bankr LLM Gateway 経由で OpenCode を起動します

ランチャーコマンド（bankr claude、bankr llm claude、bankr llm opencode）では、-h / --help を含むすべての引数が起動するツールに転送され、ヘルプの表示に認証は必要ありません。Bankr CLI 自体のヘルプを表示するには、bankr --help / bankr llm --help を使用してください。名前付きコマンドはプロンプトへのフォールスルーより優先されるため、bankr claude ... はエージェントにプロンプトを渡すのではなく Claude Code を起動します。プロンプトがコマンド名で始まる場合は、bankr agent "..." を使用してください。

bankr claude エイリアスと --help の転送には @bankr/cli 0.3.18+ が必要です。古いバージョンでは bankr llm claude を使用してください。

基本的な使い方

シンプルなクエリ

すぐに完了する簡単なリクエストの場合：

bankr agent prompt "What is my ETH balance?"
bankr agent prompt "What's the price of Bitcoin?"

CLI は、送信・ポーリング・完了までのワークフロー全体を自動的に処理します。省略形も使用できます。認識されないコマンドはすべてプロンプトとして扱われます。

bankr What is the price of ETH?

対話型プロンプト

シェルによって展開される $ や特殊文字を含むプロンプトの場合：

# Interactive mode — no shell expansion issues
bankr agent prompt
# Then type: Buy $50 of ETH on Base

# Or pipe input
echo 'Buy $50 of ETH on Base' | bankr agent prompt

会話スレッド

エージェントとの複数ターンの会話を続けます。

# First prompt — starts a new thread automatically
bankr agent prompt "What is the price of ETH?"
# → Thread: thr_ABC123

# Continue the conversation (agent remembers the ETH context)
bankr agent prompt --continue "And what about BTC?"
bankr agent prompt -c "Compare them"

# Resume any thread by ID
bankr agent prompt --thread thr_ABC123 "Show me ETH chart"

スレッド ID は、各プロンプトの後に設定へ自動的に保存されます。--continue / -c フラグを使うと、最後のスレッドを再利用できます。

手動でのジョブ制御

高度な使い方や長時間実行される操作の場合：

# Submit and get job ID
bankr agent prompt "Buy $100 of ETH"
# → Job submitted: job_abc123

# Check status of a specific job
bankr agent status job_abc123

# Cancel if needed
bankr agent cancel job_abc123

LLM ゲートウェイ

Bankr LLM Gateway は、Claude、Gemini、GPT、Grok、DeepSeek、Qwen、Kimi、MiniMax、GLM などのモデル向けの統合 API です。単一のエンドポイントを通じて、複数プロバイダーへのアクセス、コスト追跡、自動フェイルオーバー、SDK との互換性を提供します。

ベース URL： https://llm.bankr.bot | ダッシュボード： bankr.bot/llm | API キー： bankr.bot/api-keys

主な概念

llmKey が設定されている場合はそれを使用し、設定されていない場合は API キーにフォールバックします
LLM クレジット（USD）と取引ウォレット（暗号資産）の残高は完全に別です。暗号資産を保有していても、LLM クレジットは付与されません
新しいアカウントの LLM クレジットは $0 です。 LLM を呼び出す前に、bankr llm credits add 25 または bankr.bot/llm?tab=credits でチャージしてください。チャージしない場合、402 エラーが発生します
クレジットの確認：bankr llm credits | チャージ：bankr llm credits add <amount> | 自動チャージ：bankr llm credits auto --enable --amount 25 --tokens USDC
OpenClaw の設定では、モデル ID の先頭に bankr/ を付けます（例：bankr/claude-sonnet-5）。API を直接呼び出す場合は、接頭辞のない ID を使用します（例：claude-sonnet-5）。現在のモデル一覧は bankr llm models で確認できます
Claude Code の [1m] コンテキスト階層サフィックスは、ゲートウェイ経由では省略可能です。 モデルの検索前に削除され、100 万トークンのコンテキストウィンドウはモデル本来のコンテキストウィンドウから取得されるため、claude-opus-5 と claude-opus-5[1m] は同じように動作します。使用する場合は、引用符で囲んでください（--model "claude-opus-5[1m]"）。zsh ではグロブ文字クラスとして解釈されるため、CLI の実行前にコマンドが中断されます
Bankr Club のメンバーおよびパートナーはモデルごとの割引を利用できます。割引は請求時に自動適用されます
画像生成： OpenAI ネイティブの /v1/images/generations エンドポイントを使用して画像を生成できます。gpt-image-2.5 系（高速生成向けの -flare と高精度向けの -sunburst）に加えて、従来の gpt-image-2 も利用できます。すべて同じ価格で、同じ LLM クレジット残高から請求されます。詳しくはリファレンスを参照してください
有効期限付きクレジット付与： プロモーション用または開発者向けのクレジット付与には、有効期限が設定されている場合があります。利用可能な残高は、恒久クレジット（購入分）と有効期限内の付与クレジットの合計です。付与クレジットは有効期限が最も近いものから使用され、有効期限を過ぎると自動的に残高から除外されます
プライバシー階層： すべてのリクエストは standard、zdr（ゼロデータ保持）、private（TEE）のいずれかで処理されます。リクエストごと、モデルごと、ベース URL ごと、またはアカウント全体に対して階層を指定できます。詳しくは以下を参照してください

プライバシーティア

データ取り扱い保証は3段階あり、すべてのエンドポイントで同じ方法で指定できます。

ティア	保証	対象範囲
`standard`（デフォルト）	プロンプトを学習に使用するプロバイダーには決してルーティングされません。ただし、プロバイダーがプロンプトを保持する場合があります。	すべてのモデル
`zdr`	データを一切保持しないプロバイダーのみを使用します。	一部のモデル — `bankr llm models --zdr` で絞り込めます
`private`	ハードウェアで保護されたエンクレーブ（TEE）内で実行され、リクエストごとにアテステーションが検証されます。仕組み上、データは一切保持されません。	オープンウェイトモデルのみ

どのクライアントからも各ティアを指定できるよう、4つの方法があります。

# 1. The `privacy` request field
curl -X POST https://llm.bankr.bot/v1/chat/completions -H "X-API-Key: $BANKR_LLM_KEY" \
  -d '{"model":"glm-5.2","privacy":"zdr","messages":[{"role":"user","content":"Hello"}]}'

# 2. A base-path prefix — for tools that only take a base URL, key, and model
export OPENAI_BASE_URL=https://llm.bankr.bot/zdr/v1      # OpenAI-compatible clients
export ANTHROPIC_BASE_URL=https://llm.bankr.bot/zdr      # Anthropic-compatible clients

# 3. A model-ID suffix
bankr llm models --zdr                                   # which models have a ZDR slot
# → use `glm-5.2:zdr` or `glm-5.2:private` as the model ID

# 4. Account-wide — Settings in the web terminal, applies to every request

どのティアでも、条件を満たせない場合はリクエストを拒否します。 指定したモデルを希望のティアで提供できるプロバイダーがない場合、リクエストは拒否されます（422 zdr_unavailable）。通知なく低いティアに切り替わることはありません。
アカウント設定とリクエストを組み合わせ、より厳しい方が適用されます。 リクエストでアカウント設定より厳しいティアを指定できます。リクエストでアカウント設定より低いティアにすることはできません。
ティアのエンドポイントが優先されます。 /zdr または /private に異なるティアを指定したリクエストを送ると、統合されずに 400 privacy_conflict が返されます。解析できない privacy 値は無視されず、400 invalid_privacy が返されます。
X-Privacy-Tier レスポンスヘッダーには、リクエストの実際の処理に適用されたティアが示されます。これにより、保証を推測ではなく検証できます。
ティアの照合では大文字と小文字が区別されません。サフィックスによるオプトインとして認識されるのは、末尾にある :zdr / :private トークンのみです。

Max Mode — エージェントのモデルを選択する

Max Mode では、Bankr エージェントのデフォルトモデル（現在は Gemini 3.8 Flash）をゲートウェイの任意のモデルに変更でき、LLM クレジット残高からトークン単位で課金されます（取引ウォレットではありません）。

bankr agent "analyze my portfolio" --model claude-opus-5     # or -m
bankr agent "what are the top memecoins today?" -m gemini-3.1-pro
bankr agent prompt "tell me more" --continue --model claude-sonnet-5

この設定はウォレットに保存され、CLI、ウェブターミナル、ソーシャルプラットフォーム、自動化など、すべての利用環境に適用されます。ウェブターミナルでは、Max ボタンを切り替えて、ピッカーからモデルを選択します。

クレジットは事後ではなく、LLM 呼び出しごとに適用されます。 利用可能な残高から、使用量が計測済みでまだ差し引かれていない分を引いた金額が、実行時の予算となります。各呼び出しの前に残高が再確認され、予算を使い切ると超過利用せず、その時点でターンが終了します。
不足分は引き続き未払いとして残ります。 バッチ全体をクレジットでまかなえない場合、クレジットは消費されず、使用料は未払いのまま残ります。そのため、後からチャージすると精算され、超過分が帳消しになることはありません。
有効にする前にチャージしてください。チャージしないと、Max Mode のメッセージは失敗します。

クイックコマンド

bankr llm models                           # List available models
bankr llm credits                          # Check credit balance
bankr llm credits add 25                   # Top up $25 credits (defaults to Base USDC)
bankr llm credits add 25 --token USDT      # Pay USDT on whichever chain holds the most
bankr llm credits add 25 --token ETH       # Native token; auto-swapped on its chain
bankr llm credits auto --enable --amount 25 --tokens USDC,USDT  # Multi-chain auto top-up
bankr llm setup openclaw --install         # Install Bankr provider into OpenClaw
bankr llm setup claude                     # Print Claude Code env vars
bankr claude                               # Launch Claude Code through gateway
bankr claude --model claude-opus-5         # Any tool flags are forwarded
bankr llm opencode                         # Launch OpenCode through gateway

エージェントのクレジット追加

AI エージェントは会話中に LLM クレジットを直接追加できます。CLI やウェブダッシュボードは必要ありません。

bankr agent prompt "Top up my LLM credits with $25"
bankr agent prompt "Add $10 of LLM credits using my ETH"
bankr agent prompt "How many LLM credits do I have left?"

エージェントは、期限切れになる付与分やその期限も含めて、現在の LLM クレジット残高を会話中に報告できます。bankr llm credits コマンドは不要です。

別の Bankr ユーザーへのクレジット送信。 クレジットはピアツーピアで譲渡できます。エージェントに「LLM クレジットを $20、@alice に送って」と依頼するか、POST /llm/credits/transfer を使用します。受取人はすでに Bankr ユーザーである必要があります（X のユーザー名または 0x アドレス。この方法では ENS は使用できません）。最低額は $1 で、ウォレットが送信できる額は直近 24 時間で最大 $500です。読み取り専用 API キーは拒否されます。再試行による二重送信を防ぐため、ご自身の transferId を指定してください。

オプトインすると、付与されたクレジットも送信できます。 デフォルトでは、購入したクレジットのみが移動します。付与されたクレジット（オペレーターによる付与分やボーナス。期限付きのものを含む）も送信に使用するには、useGrantedCredits（transfer_llm_credits ツールのフラグ、またはウェブの「Send Credits」パネルにある「use granted credits」トグル）を設定します。

購入したクレジットが先に、手数料なしで使用されます。 付与分に達した超過額にのみ10% の手数料がかかり、送金額に上乗せして請求されます。
受取人には、入力した金額が常にそのまま届きます。 送信者からは金額と手数料が差し引かれ、手数料は焼却されるため、誰かにクレジットされることはありません。
付与された各ドルに対する手数料の請求は一度だけです。同時送信でも同じ枠を二重に請求することはなく、transferId の再送時には再請求せず、元の手数料を報告します。
フラグをオフにすれば従来の動作がバイト単位で維持されるため、既存の連携に変更は必要ありません。

上限は 2 種類あり、低い方が適用されます。 残高はご自身が保有する額を制限し、1 日あたりの使用予算は今日移動できる額を制限します。両方を確認する正式な読み取り先は GET /llm/credits/state です。creditBalanceUsd（購入済みプール）、creditGrantsUsd と creditGrants[]（有効な付与分とその期限）、totalCreditsUsd、および dailyBudget オブジェクト（limitUsd、spentUsd、remainingUsd。limitUsd: null は上限なしを意味します）が含まれます。たとえば、$265 を保有していてもローリングウィンドウにより一時的に $10 に制限されている場合、その状態が正確に表示され、資金が不足しているかのようには表示されません。残高について尋ねると、エージェントは両方の数値を提示し、どちらの上限が適用されているかを示します。

エンドポイントの使い分け： GET /llm/usage は使用状況のみを返し、過去の期間におけるトークン数と使用額を示します。クレジット残高や譲渡可能額のフィールドは含まれなくなりました。クレジットの状態は GET /llm/credits/state で確認してください。1 日あたりの送信上限を超えると、POST /llm/credits/transfer は 429 を返します。

1 日あたりの使用予算。 残高とは別に、ゲートウェイが代理で使用する額に上限を設定できます。期間は暦日ではなく、直近 24 時間です。午前 0 時にリセットされることはなく、請求が期間外になるにつれて利用枠が戻ります。予算を超えると、使用リクエストは type: daily_budget_exceeded を含む 402 を返します（insufficient_credits とは別のエラーです）。一方、読み取り専用の GET エンドポイントは引き続き利用できるため、再び利用可能になるタイミングを確認できます。同じ予算は、Max Mode のエージェント実行も早期終了させます。

1 クレジット = $1 USD です。マルチチェーンに対応しており、Base、Polygon、Ethereum、Arbitrum、BNB Chain では USDC または USDT で直接支払えます。または、その他の ERC-20 を使用できます（各チェーンで優先されるステーブルコインに自動交換されます。ほとんどのチェーンでは USDC、BNB では USDT）。--token を使用すると、CLI はそのトークンの USD 残高が最も多いチェーンを選択します。追加の上限は $1,000 です。

モデルの非推奨化

ゲートウェイはモデルの非推奨化に対応しており、代替モデルへ自動的にリダイレクトします。非推奨モデルは、X-Model-Deprecated と X-Model-Replacement のレスポンスヘッダーを返します。廃止されたモデルは HTTP 410 を返します。ヘッダーに示された代替モデルにモデル ID を更新してください。

セットアップ方法、モデル一覧、プロバイダー設定、SDK の例、キー管理、トラブルシューティングなどの詳細については、以下を参照してください。

リファレンス：references/llm-gateway.md

機能の概要

取引操作

トークンのスワップ：複数のチェーンでトークンを購入、売却、交換します
クロスチェーン：チェーン間でトークンをブリッジします
指値注文：目標価格で取引を実行します
損切り：自動売却で損失を抑えます
DCA：ドルコスト平均法による戦略です
TWAP：時間加重平均価格です

リファレンス：references/token-trading.md

ポートフォリオ管理

すべてのチェーンの残高を確認します（bankr wallet portfolio または GET /wallet/portfolio）
USD 評価額を表示します。オプションで損益を追跡できます（--pnl または ?include=pnl）
NFT 保有状況を表示します（--nfts または ?include=nfts）
トークン別またはチェーン別に保有資産を追跡します
リアルタイムで価格を更新します
複数チェーンの資産を集計します
ネイティブトークンのラップ／ラップ解除（ETH ↔ WETH など）は、両方の残高にすぐ反映されます
チェーンで絞り込みます：bankr wallet portfolio --chain base,solana または GET /wallet/portfolio?chains=base,solana

リファレンス：references/portfolio.md

市場調査

トークン価格と市場データ
テクニカル分析（RSI、MACD など）
ソーシャルセンチメント分析
価格チャート
トレンドのトークン
トークンの比較
保有者のスナップショット — 保有数量の多い順に、USD 評価額と供給量に占める割合を含む保有者リストを表示し、集中度の概要も示します。最低 USD 金額を指定できるため、エアドロップ対象者の選定（「X の保有者のうち、50 ドル以上を保有する人」）にも利用できます

リファレンス：references/market-research.md

送金

0x アドレス、ENS 形式の名前（.eth、.base.eth、.cb.id）、またはソーシャルハンドル宛てに送金します
CLI からの直接実行（bankr wallet transfer）で受け付けるのは 0x アドレスと ENS のみです。ソーシャルハンドル宛ての送金は AI エージェント経由で行います
複数のチェーンに対応します
エージェント経由の一括／複数宛先送金に対応します。同一チェーン上の ERC-20 トークンを複数の宛先に送る場合、単一のオンチェーントランザクションにまとめられます（ガス代は 1 回分です）
柔軟な金額形式に対応します
エージェント経由でソーシャルハンドル（Twitter、Farcaster、Telegram）を解決します

リファレンス：references/transfers.md

NFT 操作

コレクションを閲覧、検索します
フロア価格と出品を確認します
OpenSea 経由で NFT を購入します。ネイティブトークンではなくERC-20建ての出品（例：Robinhood Chain 上の USDG）も対象です。トークンの承認、支払い通貨の残高確認、小数桁を考慮した価格設定はすべて自動で処理されます
他の人に先を越されてもフロア価格での購入を続行します。 トークン ID を指定せずに「X の最安品」を尋ねた場合、Bankr が選んだ出品が購入中に他の人に購入されたとき（または注文が無効になったとき、署名者のシミュレーションがリバートしたとき）は、リクエスト全体を失敗させず、次に安い出品へ進みます。購入は最大 3 回試行され、返信では代替したことが明示されるため、通知なしに差し替わることはありません。トークン ID を明示した場合は、仕様上、試行は 1 回のみです
所有する NFT のオファーを受け入れます
NFT ポートフォリオを表示します
NFT を転送します
対応プラットフォームから NFT をミントします

リファレンス：references/nft-operations.md

オンチェーン報酬キャンペーン（Merkl）

エージェントは、Base と Robinhood Chain のMerklインセンティブ報酬（プロトコルが流動性提供者やトークン保有者に配布するキャンペーン報酬）を確認し、請求できます。

確認：ウォレットが獲得した報酬と現在請求可能な報酬を、チェーンごとに USD 合計額とともに確認します。自分のウォレットアドレスのみ指定できます
請求：1 回のトランザクションで、あるチェーンの請求可能な報酬を請求します。請求時は埋め込み型 Bankr ウォレットで署名するため、ウォレットモード（外部／接続済みウォレット）では利用できません
獲得機会を探す：TVL、1 日あたりの報酬、プロトコル、預け入れリンクを含む、APR 順の実施中の Merkl キャンペーンを表示します。オプションでトークンシンボルによる絞り込みも可能です

bankr agent prompt "Do I have any Merkl rewards to claim?"
bankr agent prompt "Claim my Merkl rewards on base"
bankr agent prompt "What are the best Merkl earn opportunities for USDC on base?"

キャンペーンの実施状況や参加資格は時間とともに変わります。キャンペーンがまだ実施中だと決めつけず、最新の状況をエージェントに確認してください。

Polymarketでのベッティング

予測市場を検索します
オッズを確認します
結果に賭けます
ポジションを確認します — Polymarketの入金ウォレットに残っている未使用の担保も含みます。この担保は「sweep my polymarket deposit wallet」で回収できます
賞金を引き出します

参考資料：references/polymarket.md

レバレッジ取引

Hyperliquid（主要） — オンチェーンのオーダーブックを備えたHyperliquid L1での無期限先物取引です。暗号資産、株式（HIP-3経由のTSLA、AAPL、NVDA）、現物取引に対応しています。最大50倍のレバレッジを利用できます。
Avantis（補助） — Baseでの暗号資産、株式（NVDA、TSLA、AAPL、HOODなど）、外国為替、商品を対象とした無期限先物取引です。株式、外国為替、商品ペアの取引は、それぞれの原資産市場の取引時間中に限られます。
両プラットフォームでストップロス、テイクプロフィット、ポジション管理に対応しています
Hyperliquidへの入金はブリッジではなく、取引所への入金／出金です。入金はHyperliquidにのみ届き、出金はArbitrumにのみ着金します。「ブリッジ」と言うのではなく、取引所名を指定してください（「deposit $500 to hyperliquid」）。出金した資金をさらに移動するには、出金後にクロスチェーンスワップを続けて実行します
Hyperliquidのポジションを決済すると、常にPnLが報告されます。これは決済の見積もりに使われた価格に基づきます。約定した場合は約定価格、指値注文が有効な間は指値価格、それ以外の場合はミッド価格が使われます。また、一部約定の場合は全決済としてではなく、その旨が明示されます。一時的な取引所のレート制限（429）は、注文失敗として表面化するのではなく、バックオフを伴って再試行されます
Hyperliquidでは、出金手数料1 USDCが出金要求額から差し引かれます。そのため、出金可能残高の全額を要求でき（受取額は要求額から1を差し引いた額です）、1ドル未満の出金は差し引き後にゼロになるのではなく拒否されます

参考資料：references/leverage-trading.md | references/hyperliquid.md

トークン化株式の取引

オンチェーントークンとして発行された現実世界の株式やETFを、他の資産と同じように、通常のプロンプトで取引できます。ティッカーを指定するとBankrが最適な取引所を自動的に選択します。また、チェーン／取引所を指定することもできます。

Robinhood Chain — Robinhoodが発行する現物トークン（NVDA、AAPL、TSLA、SPY、QQQなど、200銘柄の株式とETF）です。取引はUSDG（Global Dollar）で決済され、Bankrが資金を自動的に経由させます。初回のみ所在地の確認が必要です。
Base（B20トークン化株式） — Base上のCoinbase発行の株式トークンです。対象はAAPL、AMZN、COIN、CRCL、GOOGL、INTC、META、MSFT、MSTR、NVDA、SNDK、SPCX、TSLAです。Robinhood株式と同じ所在地確認が必要です。
Solana — xStocks（AAPLx、TSLAx）など、サードパーティ発行元による現物トークンです。確認は不要で、他のトークンと同様に取引できます。
Base（サードパーティ発行元） — Base上の他の発行元による現物株式トークンです。確認は不要です。
レバレッジ取引（無期限先物） — トークンを保有せずにロング／ショートのエクスポージャーを得るには、Avantis（Base）またはHyperliquidを利用します。

所在地の確認は初回のみ必要です。Bankr consoleにログインしてください（接続元に基づいて自動的に確認され、ログイン時に更新されます。有効期限は30日です）。米国、英国、または制裁対象の国・地域では利用できません。

現物株式は、スワップ、送金、指値注文、DCAで利用できます。所在地による制限の対象となるのは、発行元がトークン化した株式（Robinhood ChainとBase B20）の取引のみです。ミームコイン、ブリッジ、送金は確認なしで利用できます。ティッカーはチェーン間で重複するため（13種類のB20ティッカーのうち12種類はRobinhood Chainにも存在します）、特定のチェーンを指定する場合はチェーン名も指定してください。

参考資料：references/tokenized-stocks.md

トークンのデプロイ

EVM（Base、Robinhood Chain、または Arbitrum One）：Doppler を介して Uniswap V4 プール上に ERC20 トークンをローンチできます。メタデータやソーシャルリンクはカスタマイズ可能です。供給量は固定されており、デプロイ後にミントすることはできません。通常のローンチでは 1,000億（Web のローンチフローでは任意の数値を設定できますが、デプロイ API と CLI では常に標準の供給量を使用します）。ティッカーシンボルは 1～20文字です。すべての取引でプールに 0.7%のスワップ手数料が発生し、その95%があなたに支払われます（取引高の0.665%。いつでも請求できます）。フックにより、Bankr プロトコル手数料と BNKR 買い戻し手数料、LP 手数料が上乗せされ、**合計手数料は1.75%です。0.285%のLP手数料もクリエイター側に入ります。これはあなた自身のプールのロック済み流動性として複利で積み上がり、スワップのたびにトークンの流動性が強化されます。そのため、クリエイター側の合計は取引高の0.95%**です。デフォルトのチェーンは利用方法によって異なります。CLI（bankr launch）とWebのローンチフォームでは Base が事前選択されますが、AI エージェントとデプロイ API では、チェーンが指定されていない場合に Robinhood Chain が選択されます。該当する場合は、チェーンを明示してください（bankr launch --chain robinhood、"chain": "base"、または「Baseでローンチして」）。従来の Clanker トークンも引き続き請求できます（請求時に Doppler と Clanker が自動判別されます）。
Arbitrum One でのローンチ（chain: "arbitrum"、bankr launch --chain arbitrum、または「Arbitrumでローンチして」）では、Doppler 上で WETH とのペアのみ利用できます。pairedStockAddress と pairedTokenAddress はどちらも指定できません（Bankr Launch v3 では Arbitrum 上でより幅広い選択肢が利用できます。以下を参照）。また、ローンチウォレットが自身でネットワークのガス代を支払います（Bankr が一般ユーザーのローンチガス代を負担するのは Base のみです）。それ以外の供給量、手数料体系、クリエイターのベスティング、クオートのみの手数料、デジェンモードは、Base と同じです。
株式ペアのローンチ（Base と Robinhood Chain、任意）：新しいトークンのプールを WETH ではなく、レジストリに登録されたトークン化株式とペアにし、株式へのエクスポージャーと交換できるようにします。Base（B20 株式）と Robinhood Chain で利用できます。ペアにできる銘柄を一覧するには bankr launch quotes --chain robinhood（または --chain base）を実行し、その後 bankr launch --chain robinhood --quote TSLA（シンボルまたはアドレス）を実行します。デプロイ API では pairedStockAddress（ティッカーではなく、株式のコントラクトアドレス）と provider: "doppler" を渡してください。アドレスの一覧は GET /token-launches/quote-tokens?chain=<chain> で確認できます。または、エージェントにティッカーを指定してペアでローンチするよう依頼できます。ローンチカーブの計算には米ドル価格が必要なため、Bankr が価格を取得できる株式のみが対象です。Arbitrum では利用できません。
追加のクオートトークンでのローンチ（任意）：WETH の代わりに、チェーンごとに固定された許可リスト内のトークンをプールのクオート通貨として使用できます。Base では、BNKR、ba3Pump（Solana から Bankr 経由でブリッジされた PUMP）、cbHYPE（Coinbase 版 HYPE）、cbZEC（Coinbase 版 ZEC）、または TAO（Base 上の Bittensor）を使用できます。Robinhood Chain では、BNKR（Base の BNKR とは異なるコントラクト）または musebook（Bankr でローンチされたトークン）を使用できます。対応する固定の pairedTokenAddress と chain を渡してください。各アドレスは、それぞれのチェーン上でのみ有効です。CLI では bankr launch --chain <chain> --quote BNKR を実行すると、適切な BNKR コントラクトが選択されます（bankr launch quotes --chain <chain> で対応トークンと利用準備状況を確認できます）。ユーザーキーによるローンチのみが対象で、Arbitrum では利用できません。pairedStockAddress との併用はできず、どちらも指定しない場合は WETH が使用されます。これらのプールの取引高も、WETH をクオート通貨とするローンチと同じ条件で、週次の開発者リベートの対象になります。cbHYPE と cbZEC では、オンチェーンのクオートトークン流動性が審査されるまで、さらに待機が必要です。Bankr がペアの準備ができていないと報告した場合、それは実際にローンチが拒否されたことを意味し、WETH へのフォールバックではありません。許可リストはアドレス単位で管理されており、任意の ERC-20 をクオートトークンとして使用することはできません。
Bankr Launch v3（provider: "bankr_v3"、チェーンごとに順次ロールアウト）：Doppler に加えて利用できる2つ目のローンチプロバイダーです。固定の許可リストではなく、各チェーンのレジストリにあるすべてのクオートトークンを利用できます。Base では WETH／USDC と B20 株式、Robinhood Chain では WETH／USDG と有効なすべての Robinhood Stock Token、Arbitrum では WETH／USDC と Reality rToken（rHOOD、rAAPL、rSPCX）、Arc では USDC のみが対象です。GET /token-launches/quote-tokens?chain=<chain> を参照し、そこに示された provider を返してください。v3 でローンチする場合、クオートには pairedTokenAddress／pairedStockAddress ではなく launchV3.quoteAddress を指定します（現在の一覧は GET /launch-v3/quotes?chain=<chain> で確認できます）。株式およびプロジェクトトークンのクオート価格は、Chainlink フィードまたはローンチ時に Bankr が署名した価格から取得されます。そのため、市場が閉まっている株式をクオートに指定すると、古い価格でローンチするのではなく、ローンチが拒否されます。再試行せず、市場が開くまでお待ちください。Coinbase 発行のクオート（B20 株式、cbHYPE、cbZEC）では開発者による購入は利用できません。また、Reality rToken のリベース指数が変動すると、Bankr はそのトークンでの新規ローンチを自動的に一時停止します。references/token-deployment.md を参照してください。
EVM ではクリエイターのベスティングがデフォルトで有効です：パートナー以外のすべてのローンチでは、供給量の 15% が手数料受取人に事前発行され、1年間、30日間のクリフ付きでベスティングされます（クリフ期間は1年間に含まれ、さらに追加されるものではありません）。残りの85%がプールに供給されます。ローンチ時に無効化すると、「ベスティングなしでデプロイ」、disableVesting: true、または bankr launch --no-vesting を指定すると、供給量の100%がプールに入ります。割合やスケジュールはカスタマイズできません。受取人はローンチ時に固定され、後から手数料を受け取る権利を譲渡しても、割り当ては移動しません。クリフ期間の終了後、ベスティングされたトークンを請求できます。GET /token-launches/{tokenAddress}/vesting では、公開スケジュールとポジション（フェーズ、請求可能量、ロック中の量、アンロック済みの割合）を確認でき、トークンページまたは API から請求できます。
クオートのみの手数料（EVM、任意）：ローンチ時に有効化すると、クリエイター手数料のすべてを、ローンチしたトークンとクオートトークンの混合ではなく、クオートトークン（例：WETH）のみで受け取れます。どちらを選んでも受取総額は同じです。「クオートのみの手数料」と依頼するか、デプロイ API に quoteOnlyFees: true を渡すか、bankr launch --quote-only-fees を使用してください。手数料体系と同様、ローンチ時に固定されます。
デジェンモード（EVM、任意）：標準の開始時時価総額ではなく、2,500ドルの時価総額でトークンを開始し、ローンチ初期の変動性を最大化します。明示的なオプトインが必要です。「デジェンモード」と指定するか、デプロイ API に degenMode: true を渡してください。この数値は固定で、開始時の時価総額はカスタマイズできません。トークン名に DEGEN が含まれていてもオプトインにはならず、パートナーによるデプロイでは利用できません。
Solana：ボンディングカーブと CPMM への自動移行を備えた Raydium LaunchLab を介して SPL トークンをローンチします
両チェーンでクリエイター手数料を請求可能
Solana 用の Fee Key NFT（移行後の LP 取引手数料の50%）
手数料受取人を任意で指定でき、99.9%／0.1%で分配できます（Solana）
クリエイターと手数料受取人の両方がボンディングカーブ手数料を請求できます（ガス代はスポンサー負担）
ベスティングパラメーターを任意で指定できます（Solana）
Bankr 経由でデプロイされたトークンは、市場価格データがなくても常にポートフォリオに表示されます EVM ローンチの制限と適格性 — これらをプログラムによるデプロイフローに必ず組み込んでください:

ルール	値
カウントされるローンチ試行	Bankr ウォレットごとに、ローリング 24 時間で 3 回 — Standard、Bankr Club、パートナー組織、プロビジョニング済みパートナーウォレットのいずれでも同一
ローンチレート	最大で 1 分あたり 1 トークン
ローンチウォレットの経過時間	ランタイムスイッチ、現在はオフ。オンの場合: ウォレットが 24 時間以上経過している必要があり、これはあなたの X/ソーシャルアカウントの経過時間ではなく、Bankr がそのウォレットを作成した時点から測定されます（`TOKEN_LAUNCH_WALLET_TOO_NEW`）
ローンチウォレットの残高	ランタイムスイッチ、現在はオフ。オンの場合: ローンチチェーン上のネイティブ ETH の最低残高（`TOKEN_LAUNCH_MIN_BALANCE_REQUIRED`）
メールのみのウォレット	ローンチできるようになるまで 72 時間以上 — 上記 2 つのスイッチとは無関係です。X、Farcaster、Telegram のアカウントを連携するとこの制限が解除されます
ローンチガス	Base ではスポンサー提供。Robinhood Chain と Arbitrum: ウォレットが自身のネイティブ ETH を支払います。Arc: 0.5 USDC（Arc のガストークン）
シミュレーション	ウォレットごとに 24 時間で 20 回 — ローンチクォータとは別に上限が設定されており、それでもローンチ枠を消費することはありません
同一名、アカウント単位	同一トークン名で 1 時間に 3 回のローンチ → `429`
同一名、全アカウント合計	同一名で 1 時間に 10 回のローンチ → `429`
手数料受取アドレス単位	すべてのアカウント合計で 24 時間に 20 回のローンチ → `429`
クライアント IP 単位	24 時間に約 10 回の成功したデプロイ → `429` — 非パートナーのみ、概算値。単一のデプロイホストが最初に到達する上限です

実際に送信されたローンチのみが予算を消費します。 クォータはメタデータのピン留め直前に予約され、Bankr がチェーンに到達しなかったことを証明できる試行は、その枠を — そしてその名前/手数料受取の許容量も — 返上します。ブロードキャストされたもの、またはブロードキャストされなかったことを Bankr が証明できないものはカウントされ続けます。この分類はフェイルセーフであるため、失敗したデプロイが無料だったと決して仮定しないでください。
その予約時点より前の検証、解決、価格設定の失敗は枠を消費せず、シミュレーションも同様に消費しません（--simulate / simulateOnly）。リテールのシミュレーションは、オンになっている場合はウォレット経過時間のゲートを実行しますが、残高の最低額はいずれの場合もスキップされます。
検証済みのパートナー組織およびプロビジョニング済みウォレットのローンチパスは、ウォレットの経過時間と残高の要件を免除されますが、24 時間あたり 3 回の上限は免除されません。
リテールローンチのガススポンサーは Base のみです。 Robinhood Chain と Arbitrum では、ローンチウォレットが自身のガスを支払います。すべてのスポンサー提供パスを通じて、ウォレットは 1 日あたり最大 10 件のスポンサー提供トランザクションと $3 分のガスを利用できます — どちらか先に尽きた方で、ウィンドウがリセットされるまでスポンサー提供が終了します。
5 分間の残高上限: 非パートナーのローンチ後 5 分間、どのウォレットも**総供給量の 2%**を超えて保有できません — 受取人を 2% 超に押し上げる買いまたは転送は、上限が期限切れになるまで失敗します。これは、残高ではなく手数料を変更する約 10 秒のアンチスナイプ手数料減衰とは別のものです。パートナーのローンチは免除され、期限はローンチ時にオンチェーンでエンコードされます。
持続的な大量デプロイは自動スパム保護に引っかかる可能性があります。X パスで 1 分あたり 1 回の制限に繰り返し違反すると、アカウントが 24 時間制限されます（制限状態 — ログイン、残高、出金は引き続き機能します）。

リファレンス: references/token-deployment.md

自身のクリエイター手数料トークンの売却: Bankr は、あなたが手数料を稼ぐトークンを通常のスワップ/リミット/ストップ/DCA/TWAP ツールを通じて売却することをブロックします（購入と転送は影響を受けません）。ビルダーは代わりに Glidepath を通じて段階的に利益を確定します — これは bankr.bot のトークンページから管理される、AI がペースを調整する段階的なイグジットです。Glidepath はウェブ機能であり、CLI/API アクションではありません。詳細: https://docs.bankr.bot/token-launching/glidepath

自動化

リミット注文
ストップロス注文
DCA（ドルコスト平均法）
TWAP（時間加重平均価格）
スケジュールされたコマンド

リファレンス: references/automation.md

x402 有料 API 呼び出し

エージェントは、Base 上でトークンによる支払いを自動処理しながら、x402 で保護された API エンドポイントを検出、呼び出し、デプロイできます。

Bankr レジストリまたはウェブ検索でエンドポイントを検出
エンドポイントの料金、メソッド、入出力スキーマを確認
エンドポイントが必要とするトークン（USDC またはサポートされている ERC-20）で、自動的に支払いに署名してエンドポイントを呼び出し。上限は 1 リクエストあたり 10 ドルです。CLI では --max-payment <usd> が上限であり、実際に送信される値です。エンドポイントが提示する価格は表示のみで、上限を引き上げることはありません。提示価格が上限を超える呼び出しは、支払いを行わず失敗します
エージェントから直接、新しい x402 エンドポイントをデプロイ（ハンドラーコードの作成、価格の設定、デプロイ）
USDC またはサポートされている ERC-20 で独自のエンドポイントに価格を設定。収益はオンチェーンで決済され、決済時点の USD 額として記録されます
Bankr がホストするもの、外部のものを問わず、x402 対応のあらゆるエンドポイントで動作

リファレンス： references/x402-cloud.md

ウェブ閲覧

エージェントには、ウェブ操作用のヘッドレスブラウザーが組み込まれています。

URL を開き、ウェブページを移動
ページの内容を読み取り、データを抽出し、スクリーンショットを撮影
ページ要素を操作（クリック、入力、スクロール）
複数ステップのワークフローでブラウザーセッションを維持
調査、データ抽出、API のないウェブアプリの操作に便利

リファレンス： references/x402-cloud.md

ファイルストレージ

すべての Bankr ウォレットには永続ファイルシステムがあり、CLI、ウェブターミナル、API、およびエージェントが稼働するすべてのソーシャルプラットフォームで共有されます。

エージェントに依頼して、ファイルの作成、読み取り、編集、検索、移動、名前変更、削除ができます。パス（/research/notes.md）は、ファイル ID と同じようにどこでも使用できます
CLI では bankr files ls|upload|download|cat|edit|write|search|mkdir|rm|storage、REST では /user/files/* を使用
ファイルを読み込まずに質問できます。エージェントはサンドボックス内で読み取り専用の jq／grep／awk スタイルのパイプラインを実行して答えだけを返すため、4 MB の CSV が会話に取り込まれることはありません。すべてのウォレットで利用でき、Club のサブスクリプションは不要です
実行結果（/runs） — 会話ごとに分離された、一時作業用の名前空間です。サンドボックス化された実行が ./output/ に書き込んだ成果物は自動的にここに保存され、後のターンでもパスから読み取れます。また、大きすぎるツールの結果も会話を圧迫しないよう、ここに保存されます。テキストのみ、約 14 日間、1 ファイルあたり 10 MB／会話あたり 100 MB です。長期保存が必要なものは、自分のファイルシステムに保存してください
容量上限：無料プランでは 1 GB／1 ファイルあたり 10 MB／月間ダウンロード 10 GB、Bankr Club では 10 GB／1 ファイルあたり 50 MB／月間ダウンロード 100 GB です。書き込み時に確認され、現在の Club ステータスに基づいてリアルタイムに適用されます
削除は論理削除です。ファイルは 24 時間以内であればサポートを通じて復元でき、その後は完全に削除されます

リファレンス： references/files.md

Bankr について質問する

エージェントは、機能の仕組み、公式ドメインやリンク、公式 Telegram ボット、サポート窓口など、Bankr 自体に関する質問に答えられます。Bankr 独自のドキュメントを根拠とし、確信を持って答えられない場合は推測せず回答を控えるため、リンクや事実を捏造することはありません。初期設定に関する質問や、リンクまたはチャンネルが本当に公式かどうかの確認に便利です。

スキルでエージェントを拡張する

スキルは2 つの方向で機能するため、混同しやすい点にご注意ください。このドキュメントでは 1 つ目の方向、つまり取引できるように、あなたのエージェントに Bankr スキルをインストールする方法を説明します。2 つ目はその逆で、新しい動作を教えるために、あなたの Bankr エージェントにスキルをインストールする方法です。

リンクを貼り付けてインストールします。 公開されている GitHub フォルダーの URL（SKILL.md を含む tree/<branch>/<path>）、blob/…/SKILL.md の URL、スキルがリポジトリのルートにある場合はリポジトリの URL、または .md ファイルへの直接リンクを使用できます。bankr.bot の Discover ページやパートナーページのリンクも使用できます。正規の共有 URL と、アプリ内で UI が提供するルートのどちらも、カタログのエントリーに解決されます。
再インストールすると置き換えられます。 すでに存在する名前でスキルをインストールすると、既存のスキルが上書きされます。これが更新方法です。
サイズ制限：SKILL.md は 1 MB、references/ 以下の各ファイルは 100 KB までです。エージェントは必要に応じて、参照ファイルのテキストをインラインで読み込みます（最大 200 KB）。バイナリファイル（画像、PDF）はメタデータとパスとして渡され、コマンドラインツールに渡すことができます。
フロントマターは任意です。 フロントマターを使わない形式で公開されたスキルもインストールできます。Bankr は最初の見出しから name を、冒頭の文章から description を生成し、全文書を切り詰めずに本文として保持します。
厳選されたスキルは提案されますが、黙って使用されることはありません。 リクエストに対応するネイティブな方法がなく、厳選されたスキルで対応できる場合、まだインストールしていなくても、エージェントがそのスキルを提示できます。これにより、機能不足を単なる失敗ではなく「これをインストールしてください」と案内できます。あなたに代わってインストールされることはありません。

bankr agent skills を実行すると、エージェントが現在利用できるスキルが一覧表示されます。

任意のトランザクション

明示的な calldata を含む EVM トランザクションを生の形式で送信します
任意のアドレスに対してカスタムコントラクト呼び出しを行います
他のツールで生成した事前構築済み calldata を実行します
データ付きの値の送金を行います
不明なコントラクトの ABI を読み取り、呼び出します。struct（tuple）パラメーターは、エンコーダーが受け付ける括弧付きのシグネチャー形式に展開されます。そのため、Uniswap V4 のポジションミントのような struct を受け取る関数も、tuple としてエラーになることなく、最初からエンコードできます

リファレンス： references/arbitrary-transaction.md

対応チェーン

チェーン	ネイティブトークン	主な用途	ガス代
Base	ETH	ミームコイン、一般的な取引、B20 トークン化株式	非常に低い
Polygon	POL	ゲーム、NFT、頻繁な取引	非常に低い
Ethereum	ETH	優良銘柄、高い流動性	高い
Solana	SOL	高速取引	最小
Unichain	ETH	新しい L2 の選択肢	非常に低い
World Chain	ETH	Uniswap V3/V4 のスワップ	非常に低い
Arbitrum	ETH	DeFi、低コストのトランザクション、トークンローンチ（WETH ペア）	非常に低い
BNB Chain	BNB	BSC エコシステムでの取引	低い
Robinhood Chain	ETH	トークン化株式と ETF（USDG）、ミームコイン、トークンローンチ	非常に低い
Arc	USDC	USDC ネイティブ残高、送金、Raw トランザクション	非常に低い

Arc は Circle の EVM L1（chainId 5042）で、USDC がネイティブのガストークンです。USDC 残高は 1 つで、18 桁の小数を持つネイティブ表示と、0x3600000000000000000000000000000000000000 にある 6 桁の小数を持つ ERC-20 の両方で公開されます。ラップされたネイティブトークンはありません。Bankr は Arc 上で残高の確認、USDC/ERC-20 の送金、Raw トランザクション、コントラクトのデプロイに対応しています。アグリゲーターによるスワップにはまだ対応していません — 0x と Relay は Arc をルーティングしません。また、x402 は利用できません。ガス代はネイティブ USDC で支払い、肩代わりされないため、トランザクションを実行する前にウォレットへ資金を入れてください。

Robinhood Chain は、ネイティブのステーブルコインが USDG（Global Dollar）の EVM L2（chainId 4663）です。ミームコインに加えて、Robinhood が発行した 200 種類のトークン化株式と ETF を扱い、Bankr のトークンローンチ（Doppler）にも対応しています。トークン化株式の取引には所在地の確認が必要です（トークン化株式の取引を参照）。ミームコインのスワップ、トークンローンチ、ブリッジ、送金には必要ありません。

Arbitrum One は取引チェーンであると同時に、Doppler のローンチチェーンでもあります。ローンチは WETH ペアのみで、ガス代は肩代わりされません — デプロイ前に、Arbitrum 上の ETH をローンチ用ウォレットに入れてください。

Base では、Coinbase が発行する 8 桁の小数を持つ株式トークンである B20 トークン化株式も扱っています。原株に対する償還比率は、コーポレートアクションに応じて変動するオンチェーン乗数です。これらの取引には Robinhood 株式と同じ所在地の確認が必要ですが、Base 上のそれ以外の取引には必要ありません。

安全性とアクセス制御

Bankr には、独立した安全制御レイヤーが 2 つあります。トランザクションをブロードキャストするには、両方を満たす必要があります。

ウォレットレベルのセキュリティ（bankr.bot → セキュリティ）

チャット、エージェント、API、CLI など、すべての利用画面に適用されるユーザー管理の設定です。bankr.bot → セキュリティで設定します。ウェブ認証が必要です（API キーでは変更できません）。

制御項目	デフォルト	効果
すべての取引を一時停止	オフ	再開するまで、すべての送信取引をブロックします
1日の支出上限	500ドル／24時間	過去24時間の米ドル建て流出額が上限を超える取引を拒否します
1取引あたりの上限	500ドル	上限を超える価格の単一取引を拒否します
価格への影響の上限	オン（15%）	推定価格への影響が上限を超えるスワップを拒否します。流動性の低いプールで壊滅的な約定が起きるのを防ぎます。1～100%の範囲で調整するか、オフにできます
許可された受取先	オフ	送金／スワップ先を許可リストに制限します。新しい登録先には、設定可能なクールダウン（デフォルトは24時間）が適用されます
任意のコントラクト呼び出し	オフ（ブロック）	オフの場合、`write_contract`、raw `/wallet/submit`、任意のトランザクションツールをブロックします（スワップなど、名前付き操作は引き続き使用できます）。有効化には時間制限付きのオプトインが必要です。下記を参照してください
応答チャンネル	すべてオン	エージェントが返信できる場所をチャンネルごとに制御します（X、Farcaster、Telegram）。無効なチャンネルは通知なしでスキップされます。Telegram でのアカウント管理（`/start`、ウォレットのリンク）は引き続き利用できます

米ドル価格を取得できず、上限が有効な場合、取引はそのまま通すのではなく、拒否されます（フェイルクローズ）。ご自身のウォレットアドレスは、常に受取先として暗黙的に許可されています。

支出上限は、クロスチェーンや Solana の取引を含む、すべてのスワップ経路に適用されます。実行前に売却側の価格が算出され、確認されます。また、スワップが成功すると、過去24時間の合計額に加算されます。

デフォルトの500ドルは実際の上限であり、仮の値ではありません。 1日の上限／1取引あたりの上限を一度も変更していないウォレットには、エージェントの事前チェックを通らない経路（x402 の呼び出し、raw /wallet/submit、署名者への直接呼び出しなど）を含む、すべての経路で500ドルの上限が適用されます。大きな取引に署名するインテグレーションでは、未設定のウォレットに上限がないと思い込まず、明示的に上限を引き上げてください。

知っておくべき副作用として、価格への影響の上限は、影響値を報告できない取引所でもフェイルクローズになります。わかりやすい例は、まだ LaunchLab のボンディングカーブ上にある新規 Solana トークンです。上限が有効な場合、保護なしで約定させるのではなく、そのフォールバック取引は拒否されます。こうした約定が特に必要な場合は、上限をオフにしてください。

時限ウィンドウ（自動復元）

保護機能を無期限にオフにするのではなく、一定時間だけオフにし、期限が来たら自動的に復元できます。利用できるのは、1日の上限、1取引あたりの上限、価格インパクト上限、任意のコントラクト呼び出し、各応答チャネルです。指定できる期間は10、30、60、1440分に限られます。

期限が切れたときは、必ずより安全な状態になります。 保護機能では、オフの間にタイマーが動き、ウィンドウの期限が切れると機能が復元されます。任意のコントラクト呼び出しでは仕組みが逆になり、呼び出しが有効な間にタイマーが動き、期限が来ると無効になります。つまり、どちらの場合も期限切れによって制限が強化され、解除されることはありません。
状態の解決は読み取り時に行われます。 定期実行の処理は介さないため、次の取引を評価する時点ですでに期限切れのウィンドウが反映されます。競合できる隙間はありません。
明示的な書き込みのたびにタイマーが置き換わります。 設定の切り替えや金額の編集を行うと、実行中のウィンドウは解除されます。そのため、関係ないと思っていた変更の後も、古いオフのウィンドウが残ることはありません。
ウィンドウの期限はサーバー側で計算されます。 選択した期間に基づいて決まるため、独自の期限を API に渡すことはできません。

これらは、Security 画面のほかの設定と同様に、ウェブ認証が必要な設定です。API キーで解決済みの状態（/user、/user/security）を読み取ることはできますが、変更はできません。「上限がオフ」という状態には期限が伴うものとして扱ってください。長時間稼働するインテグレーションでは、起動時に読み取った値をキャッシュするのではなく、解決済みの設定を再読み込みしてください。

保護対象トークンのスワップガード

Bankr は、スワップするとほぼ確実に大きな損失につながる、一部の保護対象トークンのスワップをブロックします。たとえば、専用の償還手続きで引き出すべきステーキングポジションなどが該当します。ブロックされるのはスワップのみです。トークンはポートフォリオに表示されたまま、送金でき、関連するステーキング／償還ツールでも利用できます。スワップがブロックされた場合、エージェントは適切な引き出し方法を案内する明確な理由を返します。このガードは、EVM のスワップ経路におけるスワップ／上限／ストップ／DCA／TWAP ツール全体に適用されます。

偽装トークンのスクリーニング

よくある攻撃では、本物ではないアドレスから、正式な通貨のティッカー（USDG、USDC、USDT、EURC、またはチェーンのネイティブシンボルやラップドシンボル）を名乗るごく少量のトークンをエアドロップします。残高一覧からエージェントがそのアドレスをそのままコピーして取引に使うことを狙ったものです。Bankr は、このパターンに対するセキュリティ判定が否定的であれば、決定的なものとして扱います。該当トークンはポートフォリオ一覧から除外され、symbol: "USDG" のような一見正当なエントリーとしてエージェントに渡ることはありません。

このスクリーニングの対象は意図的に限定されています。本物の正式なトークンはアドレスで照合されるため影響を受けません。流動性のある新規ローンチには必要な、より寛容な分類が適用されます。また、Bankr 経由で実際に購入したトークンは、スパム判定によって非表示になることはありません。対象となるのは、依頼していない少量のエアドロップのみです。特定の資産を指定したい場合は、残高一覧からコピーしたアドレスではなくティッカーを指定すると、Bankr が審査済みのコントラクトに解決します。

BNKR ステーキングは引き出し専用

BNKR ステーキングは非推奨となり、新たな入金は受け付けていません。エージェントに BNKR のステーキングを依頼しても、トランザクションではなく説明が返されます。既存のステーキング参加者は、クールダウンの開始、シェアの償還、出金という一連の引き出し手続きを引き続き利用でき、ステーキング中のポジションも確認できます。入金が通ることを前提としたフローは構築しないでください。

API キーレベルの制御（bankr.bot/api-keys）

bankr.bot/api-keys で設定するキーごとの設定：

API キーの種類：Bankr は、機能フラグ（walletApiEnabled、agentApiEnabled、tokenLaunchApiEnabled、llmGatewayEnabled）付きの単一のキー形式（bk_...）を使用します。bankr config set llmKey または BANKR_LLM_KEY を使って、LLM Gateway 用の別のキーを任意で設定できます。これは、エージェントと LLM のアクセス権限を個別に管理したい場合や、別々に失効させたい場合に便利です。

読み取り専用 API キー：新しいキー（ウェブまたは CLI）は、デフォルトで読み書き可能です。bankr login email の実行時に --read-only を渡すか、bankr.bot/api-keys で Read Only を有効にすると、読み取り専用にできます（bankr login siwe のキーは、--read-write を渡さない限り、読み取り専用で開始します）。読み取り専用にすると、エージェントセッションからすべての書き込みツール（スワップ、送金、ステーキング、トークンのローンチなど）が除外されます。また、書き込みエンドポイント /wallet/swap、/wallet/sign、/wallet/submit、/wallet/transfer は 403 を返します（読み取りエンドポイント /wallet/swap-quote は引き続き動作します）。監視ボットや調査エージェントに最適です。

IP 許可リスト：API キーに allowedIps を設定すると、特定の IP または CIDR 範囲（例：10.0.0.0/24）からの利用に制限できます。許可リストにない IP からのリクエストは、認証レイヤーで拒否され、403 が返されます。

受取先許可リスト：キーからの送金先アドレスを制限します。ウォレットレベルの許可された受取先とは独立しており、両方が設定されている場合は、両方の条件を満たす必要があります。

受取先許可リストを設定すると、相手先を確認できない操作も無効になります。 一部の操作では、許可リストとの照合ができないアドレスに支払いが行われます。たとえば、マーケットプレイスのエスクロー、ミントコントラクト、予測市場の取引所などです。こうした操作が制限をすり抜けないよう、Bankr は、キーに空でない許可リストが設定されている場合（EVM または Solana）、これらの操作を拒否します：Polymarket での購入と売却、NFT の購入、ミント、出品、オファーの受諾、およびエアドロップツール。エラーには操作名が示され、キー管理者への問い合わせが案内されます。スワップと送金には影響しません。これらは受取先を確認できるためです。エージェントでこれらの操作が必要な場合は、許可リストのないキーを使用し、代わりに利用額の上限で制限してください。

インシデント対応

キーが侵害された疑いがある場合：

bankr.bot → Security でウォレットを一時停止します。すべての送信トランザクションがただちに停止します
すべてのセッションからサインアウトします。Security の「Active sessions」パネルにある Sign out of all を実行すると、現在使用中のデバイスを含め、すべての有効なセッションを一度に失効させます。キーだけでなくアカウント自体が侵害された疑いがある場合に使用してください
bankr.bot/api-keys でキーを失効させます
キーをローテーションします。新しいキーを生成し、デプロイ環境を更新します
監査します。一時停止を解除する前に、最近のトランザクションとエージェントのジョブ履歴を確認します

一般

エージェント専用ウォレット：自律型エージェントを構築する場合は、個人のウォレットではなく、別の Bankr アカウントを作成してください。これによりエージェントの資金を分離でき、キーが侵害されても、影響を受けるのはエージェント用ウォレットだけです。限られた額を入金し、必要に応じて補充してください。

レート制限：1 日あたり 100 メッセージ（標準）、1,000 メッセージ（Bankr Club）、またはキーごとのカスタム設定です。最初のメッセージから 24 時間後にリセットされるローリングウィンドウ方式です。LLM Gateway はクレジットベースのシステムを使用します。

キーの安全に関するルール：

キーは環境変数（BANKR_API_KEY、BANKR_LLM_KEY）に保存し、ソースコードには絶対に記述しないでください
~/.bankr/ と .env を .gitignore に追加してください。CLI は認証情報を ~/.bankr/config.json に保存します
本番環境で使用する前に、低コストのチェーン（Base、Polygon）で少額を使ってテストしてください
/wallet/submit では waitForConfirmation: true を使用してください。トランザクションは確認プロンプトなしで即時に実行されます
ダッシュボードまたは API キーローテーションエンドポイントから定期的にキーをローテーションし、侵害された場合は bankr.bot/api-keys でただちに失効させてください

リファレンス：references/safety.md

よくあるパターン

取引前の確認

# Check balance
bankr wallet portfolio --chain base

# Check price
bankr agent prompt "What's the current price of PEPE?"

# Then trade
bankr agent prompt "Buy $20 of PEPE on Base"

ポートフォリオのレビュー

# Direct portfolio check (no AI agent, instant response)
bankr wallet portfolio
bankr wallet portfolio --pnl        # Include profit/loss data
bankr wallet portfolio --nfts       # Include NFT holdings
bankr wallet portfolio --all        # PnL + NFTs
bankr wallet portfolio --chain base
bankr wallet portfolio --chain base,solana
bankr wallet portfolio --json

# Via AI agent (natural language, richer context)
bankr agent prompt "Show my complete portfolio"

# Chain-specific
bankr agent prompt "What tokens do I have on Base?"

# Token-specific
bankr agent prompt "Show my ETH across all chains"

自動化の設定

# DCA strategy
bankr agent prompt "DCA $100 into ETH every week"

# Stop loss protection
bankr agent prompt "Set stop loss for my ETH at $2,500"

# Limit order
bankr agent prompt "Buy ETH if price drops to $3,000"

市場調査

# Token discovery
bankr tokens search PEPE
bankr tokens info USDC

# Price and analysis
bankr agent prompt "Do technical analysis on ETH"

# Trending tokens
bankr agent prompt "What tokens are trending on Base?"

# Compare tokens
bankr agent prompt "Compare ETH vs SOL"

API ワークフロー

Bankr は非同期のジョブベース API を使用します。

送信 — プロンプトを送信し（threadId は任意）、ジョブ ID とスレッド ID を取得します
ポーリング — 2 秒ごとにステータスを確認します
完了 — 完了したら結果を処理します
続行 — 複数ターンの会話では threadId を再利用します

bankr agent prompt コマンドがこれを自動的に処理します。REST API を直接使用する場合は、ポーリングループを自分で実装してください（上記のオプション 2 または以下のリファレンスを参照）。CLI で手動でジョブを制御するには、bankr agent status <jobId> と bankr agent cancel <jobId> を使用します。

API の構造、ジョブの状態、ポーリング戦略、エラー処理の詳細については、以下を参照してください。

リファレンス：references/api-workflow.md

同期エンドポイント（Wallet API）

直接署名してトランザクションを送信するには、Wallet API の同期エンドポイントを使用します。

POST /wallet/sign - ブロードキャストせずにメッセージ、型付きデータ、またはトランザクションに署名します
POST /wallet/submit - 生のトランザクションをブロックチェーンに直接送信します
POST /wallet/transfer - シンボルの解決とマルチチェーン対応によりトークンを送金します

これらのエンドポイントは即座に応答するため（ポーリングは不要）、以下に最適です。

認証フロー（メッセージへの署名）
ガス代不要の承認（EIP-712 の許可への署名）
構築済みトランザクション（生の calldata の送信）
プログラムによるトークン送金

リファレンス：references/sign-submit-api.md

エラー処理

よくある問題と解決方法：

認証エラー → bankr login を実行するか、bankr whoami（CLI）を確認します。または、X-API-Key ヘッダー（REST API）が正しいことを確認します
残高不足 → 資金を追加するか、金額を減らします
トークンが見つからない → シンボルとチェーンを確認します
トランザクションがリバートした → パラメーターと残高を確認します
レート制限 → 待ってから再試行します

エラーの包括的なトラブルシューティング、セットアップ手順、デバッグ手順については、以下を参照してください。

リファレンス：references/error-handling.md

ベストプラクティス

セキュリティ

API キーや LLM キーを決して共有しないでください
自律型エージェントには、資金を制限した専用のエージェントウォレットを使用します
監視専用および調査専用のエージェントには、読み取り専用 API キーを使用します
既知の IP アドレスを持つサーバー側エージェントには、IP ホワイトリストを設定します
大口送金の前にアドレスを確認します
レバレッジ取引ではストップロスを使用します
キーはソースコードではなく環境変数に保存し、~/.bankr/ を .gitignore に追加します

包括的な安全ガイドについては、references/safety.md を参照してください。

取引

取引の前に残高を確認します
知名度の低いトークンではチェーンを指定します
ガス代を考慮します（少額の場合は Base／Polygon を使用します）
少額から始め、テスト後に規模を拡大します
より良い価格で取引するには指値注文を使用します

自動化

まず少額で自動化をテストします
有効な注文を定期的に確認します
現実的な価格目標を設定します
レバレッジを使用する場合は、必ずストップロスを設定します
実行状況を監視し、必要に応じて調整します

成功のヒント

初めて利用する方へ

まず残高確認と価格照会から始めます
最初は 5～10 ドルの取引でテストします
手数料の低い Base を使用します
初めのうちは取引確認を有効にします
一度に 1 つの機能を習得します

経験豊富なユーザー向け

戦略に自動化を活用します
分散のために複数のチェーンを使用します
DCA とストップロスを組み合わせます
高度な機能（レバレッジ、Polymarket）を試します
チェーン間のガス代を監視します

カテゴリー別のプロンプト例

取引

「Base で ETH を 50 ドル分購入」
「0.1 ETH を USDC にスワップ」
「PEPE の保有量の 50% を売却」
「Polygon から Base に 100 USDC をブリッジ」

トークン化株式

「robinhoodでNVDAを$100分購入」（現物、所在地の確認が必要）
「robinhoodでETHの$50分をSPYにスワップ」
「robinhoodで保有しているAAPLの半分を売却」
「baseでNVDAを$100分購入」（B20株式、所在地の確認が必要）
「baseでUSDCの$50分をGOOGLにスワップ」
「solanaでAAPLxを$50分購入」（xStocks、確認不要）
「毎週金曜日にSPYを$50分ドルコスト平均法で購入」
「avantisでTSLAを5倍レバレッジでロング」（レバレッジ付き無期限先物）
「hyperliquidでHOODをショート」

ポートフォリオ

bankr wallet portfolio（直接実行、AI 処理なし — デフォルトで価値の低いトークンを非表示）
bankr wallet portfolio --pnl（損益を含める）
bankr wallet portfolio --nfts（NFT の保有状況を含める）
bankr wallet portfolio --all（損益 + NFT）
bankr wallet portfolio --chain base（単一チェーン）
「ポートフォリオを表示」
「ETHの残高は？」
「ポートフォリオの合計額」
「Baseでの保有資産」

残高一覧は、エージェント経由の場合も含め、フィルタリングされます。 すべての残高表示では、ウォレットのshowLowValueTokens設定とその$1のしきい値に基づき、デフォルトで価値の低い保有資産が非表示になり、エージェントは除外した数をhiddenLowValueTokensとして報告します。ネイティブガスの行は常に表示されます。また、フィルタリングされた一覧だけでは、ウォレットにほかの保有資産がないとは判断できません。すべてを確認するには、includeLowValueTokensを指定して問い合わせてください。ティッカーを指定して売却や送金を行う場合は、しきい値なしで実際の保有資産と照合されるため、わずかな数量のポジションでも取引できます。references/portfolio.mdを参照してください。

市場調査

「Bitcoinの価格は？」
「ETHの価格を分析」
「Baseでトレンドのトークン」
「UNIとSUSHIを比較」
「baseで0x...の上位保有者は誰？」
「solanaで少なくとも$50分を保有する0x...の保有者を一覧表示」（エアドロップ対象者の選定）

ファイル

「この分析を/research/base-vs-solana.mdとして保存」
「自分のファイルからhyperliquidを検索」
「/exports/portfolio.csvでpnlがマイナスの行はいくつ？」
「/data/candidates.jsonで最も高いスコアは？」

送金

「0.1 ETHをvitalik.ethに送金」
「USDCを$20分@friendに送金」
「50 USDCを0x123...に送金」
「次のアドレスそれぞれに5 USDCを送金：0x..., 0x..., 0x...」（一括 — 1つのトランザクションにまとめて実行）

NFT

「Bored Apeのフロア価格を表示」
「最安のPudgy Penguinを購入」
「自分のNFTを表示」

Polymarket

「Trumpが勝つ確率は？」
「[market]のYesに$10賭ける」
「自分のPolymarketのポジションを表示」

レバレッジ

「hyperliquidでBTCを$100分、10倍でロング」
「hyperliquidでETHを5倍でショート」
「ETHを$100分、5倍でロングするポジションを開く」
「BTCを10倍でショートし、$45kで損切り」
「hyperliquidでTSLAを5倍でロング」（HIP-3経由の株式）
「hyperliquidでspacexをロング」（企業名は対応するHIP-3ティッカーに解決されます。例：SPCX）
「自分のhyperliquidのポジションを表示」
「自分のAvantisのポジションを表示」

自動化

「毎週ETHを$100分ドルコスト平均法で購入」
「ETHを$3,000で購入する指値注文を設定」
「すべての保有資産に対して-20%で損切り」

トークンのデプロイ

Solana（LaunchLab）：

「SolanaでMOONという名前のトークンをローンチ」
「FROGという名前のトークンをローンチし、手数料を@0xDeployerに送る」
「SpaceRocketをシンボルROCKでデプロイ」
「BRAINをローンチし、手数料を7xKXtg...に振り分ける」
「MOONで請求できる手数料はいくら？」
「MOONの手数料を請求」（作成者または手数料受取人が利用できます）
「自分のFee Key NFTを表示」
「ROCKETの手数料NFTを請求」（移行後）
「MOONの手数料を7xKXtg...に送金」

EVM（Base、Robinhood Chain、Arbitrum、Doppler経由）：

「BaseでBankrFanという名前、シンボルBFANのトークンをデプロイ」
「ArbitrumでMOONをローンチ」（WETHペアのみ。ガス代はウォレットが自身で支払います）
「クォートトークンのみで手数料が発生するトークンをローンチ」（作成者の手数料はすべてクォートトークンで徴収）
「degenモードでMOONをローンチ」（時価総額$2,500で開始）
「TAOとペアにしてBaseでFROGをローンチ」（BNKR、ba3Pump、cbHYPE、cbZECも利用可能）
「ベスティングなしでトークンをローンチ」（デフォルトの作成者割り当て15%をスキップ）
「MTKの割り当てのうち、ベスティング済みなのはいくら？」
「ベスティング済みのMTKを請求」
「自分のトークンMTKの手数料を請求」

オンチェーン報酬

「請求できる Merkl 報酬はありますか？」
「base 上の Merkl 報酬を請求する」
「base 上の Merkl 獲得機会を表示する」
「USDC の Merkl で最も良い APR は？」

LLM クレジット

「LLM クレジットに $25 をチャージする」
「LLM クレジットを $50 追加する」
「残りの LLM クレジットはいくらですか？」
「自分の ETH を使って LLM クレジットをチャージする」
「Polygon 上の USDT を使って LLM クレジットに $25 をチャージする」
「BNB 上の USDT で支払って LLM クレジットを $10 追加する」
「@alice に $20 分の LLM クレジットを送る」
「LLM クレジットの 5 ドルを 0xRecipient に送金する」

x402 有料 API 呼び出し

「感情分析用の x402 エンドポイントを探す」
「x402 の天気エンドポイントを呼び出す」
「価格データに利用できる x402 エンドポイントは？」
「暗号資産価格を返す x402 エンドポイントをデプロイする」
「記事を要約する x402 サービスを作成する」

Web ブラウジング

「coingecko.com を閲覧してトップトレンドのトークンを取得する」
「この URL にアクセスしてトークンのコントラクトアドレスを抽出する」
「Uniswap UI で現在の ETH/USDC プール統計を確認する」

任意のトランザクション

「このトランザクションを送信する: {to: 0x..., data: 0x..., value: 0, chainId: 8453}」
「この calldata を Base 上で実行する: {...}」
「この JSON で raw トランザクションを送信する: {...}」

送金（直接）

AI 処理を介さずに CLI または Wallet API 経由でトークンを送金します。CLI の --to は 0x アドレスまたは ENS 形式の名前（.eth、.base.eth、.cb.id）を受け付けます。Wallet API は同じものに加えて、/addresses/resolve が理解するものすべてを受け付けます。ソーシャルハンドル（Twitter、Farcaster、Telegram）の場合は AI エージェントを使用してください。

# CLI — token symbol resolution + ENS resolution built in
bankr wallet transfer --to vitalik.eth --token USDC --amount 50 --chain base
bankr wallet transfer --to name.base.eth --native --amount 0.01
bankr wallet transfer --to 0x1234... --token ETH --amount 0.1

# REST API
curl -X POST "https://api.bankr.bot/wallet/transfer" \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to": "vitalik.eth", "token": "USDC", "amount": "50", "chain": "base"}'

スワップ（直接）

AI 処理を介さずに CLI または Wallet API 経由でトークンをスワップします。CLI（bankr wallet swap）は同一チェーン EVM のスワップのみを実行します。Wallet API（/wallet/swap、/wallet/swap-quote）はクロスチェーンおよび Solana のレッグも処理します。同一チェーン EVM は高速な直接パスにとどまり、クロスチェーンまたは Solana のレッグは同じエンドポイントの背後で Relay を経由してルーティングされます。CLI はトークンシンボルをコントラクトに解決し、実行時にクォートの minBuyAmount をスリッページ保護として使用します。

ベニューの選択は自動であり、Wallet API はエージェントが対応するのと同じエッジケースをカバーするようになりました — ルートを選ぶ必要はありません:

同一チェーン上の EVM は DEX アグリゲーターを経由し、流動性の薄いチェーンではダイレクトプールの会場が優先されます。クロスチェーンおよび Solana を含むレッグ はブリッジ／スワップアグリゲーターを経由します
真新しい Solana トークン がまだ Raydium LaunchLab のボンディングカーブ上にあり、アグリゲーターのルートがまだ存在しない場合は、「ルートなし」で失敗する代わりにカーブへフォールバックします。フォールバックは限定的です。両方のレッグが Solana 上、未移行のカーブを持つ SOL ↔ トークンのペア、アグリゲーターからの真のルートなし、そしてウォレットに価格インパクトの上限が設定されていないこと — カーブはチェックできるインパクトの数値を公開しないため、Bankr はガードできない会場を埋めるのではなくフェイルクローズします。価格インパクト保護が有効な場合、これらのスワップは設計上拒否されます（minBuyAmount の下限は約定の内部で引き続き適用されます）
Polygon の pUSD → USDC.e は DEX の見積もりではなく、オンチェーンの 1:1 Offramp アンラップを使用します。手数料なし、スリッページなし、価格インパクトなしです。エージェントに Polygon 上で pUSD を素の「USDC」へ変換するよう依頼すると USDC.e に解決され、この経路をたどります — そのリクエストは、それが意味しうる唯一のルーティング可能なものとして解釈されるため、見積もり、署名カード、確認のすべてが USDC.e を示し、ペアのルーティングが失敗することはありません。逆方向（USDC.e → pUSD）は通常のペアと同様に見積もられ、pUSD の購入は影響を受けません — Offramp はアンラップしかできません。アンラップはあなた自身のウォレットへ決済されるため、別の受取人を指定したスワップアンドセンドは代わりに通常の会場を経由します — あなたに無言で決済されることは決してありません
Robinhood Chain のトークン化株式 はアグリゲーターの RFQ メーカーを通じて見積もられ約定され、USDG に対して決済されますが、通常の Robinhood Chain ペアは薄いプールの保護を維持します
ウォレットモードのスワップ — Bankr が保管するウォレットではなく、外部／接続されたウォレットから署名する場合 — は、他のすべてのスワップと同じ会場順序をたどるようになったため、流動性の薄いペアはブリッジアグリゲーターへ迂回されるのではなく、ダイレクトプールの会場へ到達します。実用的な効果として、以前は承認とルーター呼び出しを必要としたルートが、署名する単一のトランザクションとして返ってくるようになり、ビルドに失敗したレッグは成功メッセージの下で署名対象として渡されるのではなく、失敗として報告されます
/wallet/swap-quote は実行と同じようにフォールバックします。 プライマリアグリゲーターが EVM ペアでルートなしを報告すると、見積もりは「見積もりを利用できません」を返すのではなく、ブリッジ／スワップアグリゲーターを再試行します。これは、唯一のプールが特殊なものであるペアにとって最も重要です — たとえばトークン化株式で見積もられるローンチプールは、プライマリアグリゲーターがシングルホップでは約定しますが、中間として経由して組み立てることはしません。見積もりと実行がルーティング可能なものについて一致するようになったため、取得できる見積もりは約定できる見積もりです

# CLI — quote only (no execution)
bankr wallet swap --from ETH --to USDC --amount 0.1 --chain base --quote-only

# CLI — quote then execute
bankr wallet swap --from ETH --to USDC --amount 0.1 --chain base

# REST API — quote (read; read-only keys allowed)
curl -X POST "https://api.bankr.bot/wallet/swap-quote" \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fromChain": "base", "fromToken": "0x...", "toChain": "base", "toToken": "0x...", "amount": "0.1"}'

# REST API — execute (write; pass the quote's minBuyAmount for slippage protection)
# Always send an idempotencyKey so a retried request can't broadcast a second swap
curl -X POST "https://api.bankr.bot/wallet/swap" \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fromChain": "base", "fromToken": "0x...", "toChain": "base", "toToken": "0x...", "amount": "0.1", "minBuyAmount": "...", "idempotencyKey": "<uuid>"}'

# REST API — cross-chain (Base → Solana): distinct fromChain/toChain, base58 mint on the Solana leg
curl -X POST "https://api.bankr.bot/wallet/swap-quote" \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fromChain": "base", "fromToken": "0x...", "toChain": "solana", "toToken": "<base58-mint>", "amount": "25"}'

/wallet/swap* エンドポイントはトークンのコントラクトアドレスを受け取ります — EVM のレッグは 0x アドレス（チェーンのネイティブトークンの場合はゼロアドレス）、Solana のレッグは base58 ミントを使用します。CLI がシンボルを解決します。クロスチェーンまたは Solana のスワップでは、fromChain／toChain を異なるチェーン（または solana）に設定すると、エンドポイントが自動的にそのルートを見積もり／実行します。スワップの出力は常にあなた自身のウォレットへ返されるため、allowedRecipients は適用されません。サポートされる EVM チェーンには base、mainnet、polygon、unichain、arbitrum、bnb、worldchain、robinhood が含まれ、さらに solana があります。robinhood 上のトークン化株式に触れるスワップを実行するには、どちらかのレッグでロケーションチェックに合格している必要があります — これがないと /wallet/swap は 403 を返し、Bankr コンソールで検証するよう案内します。見積もりはゲートされないため、/wallet/swap-quote の成功は実行の許可ではありません。実行は、Bankr Terminal のトランザクションごとおよび 1 日あたりの支出上限に対してもチェックされます（上限を超える場合は 403 が返されます）。

オプションのスワップパラメーター

フィールド	場所	説明
`slippageBps`	quote + execute	最大スリッページ許容値（bps）。`10`–`2000`。デフォルトは `500`（5%）で、クォートの `minBuyAmount` を設定します
`quoteId`	execute	新しいクォートの `quoteId` を引き継いで再利用し、再価格設定をスキップします。古い、不明、または不一致の ID は、通知なしに新しいクォートにフォールバックします
`idempotencyKey`	execute	UUID による重複送信の防止機能です。同じキーで POST を再実行すると、再度ブロードキャストする代わりに元の結果を返します

クォートレスポンスで保証されるのは from、to、minBuyAmount のみです。価格を設定した取引所によっては、feeBps（0 = 手数料無料）、feeWaivedForEcosystemToken、slippageBps、priceImpactBps（表示用の推定値）、swapImpactBps（実行時の判定に使用する手数料を除いた値）、networkCostsUsd、maxPriceImpactBps（ウォレットの保護上限）、sellTokenPriceUsd、buyTokenPriceUsd、quoteId も取得できます。フィールドが欠落している場合は、ハードブロックするのではなく、null／不明として扱ってください。

実装時に考慮すべき注意点が 2 つあります。

アグリゲーター経由では、実行時に slippageBps が上限処理されます。 クォートの minBuyAmount には常に反映されますが、許容値がそのまま約定に適用されるのは Relay 経由のペア（クロスチェーン、Solana、Relay 優先のチェーン。ただしトークン化株式のレッグは除く）のみです。それ以外では、仕様により実行時の再クォートは 2%（200 bps） に制限されます。そのため、より緩いクォート許容値と実行時のより厳しい許容値との差は、価格変動に対する余裕であり、実際のスリッページではありません。
quoteId の再利用が有効なのは同一チェーンの EVM のみです。 クロスチェーンおよび Solana の実行では、保存済みクォートの検索より先にルーティングが行われるため、ID は受け付けられますが無視されます。

スワップのエラーの意味

ステータス	意味
`400`	リクエスト本文が無効、未対応のチェーン、同一トークンのスワップ、金額が小さすぎる、残高またはガス不足、取引不可能なペア、取引所側で価格インパクトが高すぎる、またはウォレットに Solana アドレスがない
`403`	読み取り専用キー、ウォレットが一時停止中、地域確認の失敗、購入トークンが禁止またはスキャンでフラグ付けされている、価格インパクトがウォレット独自の上限を超えている、手数料受取先が自身の手数料トークンを売却している、または使用上限を超える
`409`	同じ `idempotencyKey` を使ったスワップが処理中、または保留中のトランザクションが妨げになっている
`429`	レート制限 — 安全に再試行できます
`502`	実行時に新しいクォートを取得できない、Relay の約定に失敗した、または LaunchLab の約定はブロードキャストされたものの確認できなかった
`503`	スワップサービスが一時的に利用できない — 安全に再試行できます
`504`	送信済みですが、確認に予想以上の時間がかかっています

504 や LaunchLab の 502 を、状況を確認せずに再試行しないでください。 どちらも、トランザクションがすでにオンチェーンにある可能性があることを意味します。ブロードキャストは済んでいて、確認のみが完了していません。再試行する前に、ウォレットのアクティビティでハッシュを確認してください。それ以外は、ブロードキャスト前（安全に再試行可能。できれば同じ idempotencyKey を使用）か、最終的なエラーのいずれかです。

価格インパクトによる拒否には、意味の異なる 2 種類があります。400 は取引所が取引を拒否したことを示します（プールが取引を処理できません。金額を減らして再試行してください）。一方、403 は、ウォレット独自の価格インパクト保護が、実行時に取得した新しいクォートを拒否したことを示します。この 403 を認証や地域の問題と解釈しないでください。

Sign API（同期）

AI 処理を介さずにメッセージを直接署名します。

# Sign a plain text message
curl -X POST "https://api.bankr.bot/wallet/sign" \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"signatureType": "personal_sign", "message": "Hello, Bankr!"}'

# Sign EIP-712 typed data (permits, orders)
curl -X POST "https://api.bankr.bot/wallet/sign" \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"signatureType": "eth_signTypedData_v4", "typedData": {...}}'

# Sign a transaction without broadcasting
curl -X POST "https://api.bankr.bot/wallet/sign" \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"signatureType": "eth_signTransaction", "transaction": {"to": "0x...", "chainId": 8453}}'

Submit API（同期）

AI 処理を介さずにトランザクションを直接送信します。

# Submit a raw transaction
curl -X POST "https://api.bankr.bot/wallet/submit" \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction": {"to": "0x...", "chainId": 8453, "value": "1000000000000000000"},
    "waitForConfirmation": true
  }'

リファレンス：references/sign-submit-api.md

リソース

ドキュメント：https://docs.bankr.bot
LLM Gateway ドキュメント：https://docs.bankr.bot/llm-gateway/overview
API キー管理：https://bankr.bot/api-keys
ターミナル：https://bankr.bot/terminal
CLI パッケージ：https://www.npmjs.com/package/@bankr/cli
Twitter：@bankr_bot

トラブルシューティング

CLI が見つからない

# Verify installation
which bankr

# Reinstall if needed
bun install -g @bankr/cli

認証の問題

CLI：

# Check current auth
bankr whoami

# Re-authenticate
bankr login

# Check LLM key specifically
bankr config get llmKey

REST API：

# Test your API key
curl -s "https://api.bankr.bot/_health" -H "X-API-Key: $BANKR_API_KEY"

API エラー

包括的なトラブルシューティングについては、references/error-handling.md を参照してください。

ヘルプを利用する

CLI 出力または API レスポンスのエラーメッセージを確認します
bankr whoami を実行して認証を確認するか（CLI）、/_health に curl を送信してテストします（REST API）
関連するリファレンスドキュメントを参照します
まず簡単なクエリでテストします（bankr agent prompt "What is my balance?" または POST /agent/prompt）

プロのヒント：最もよくある問題は、トークンのチェーンを指定していないことです。迷ったときは、プロンプトに必ず「on Base」または「on Ethereum」を含めるか、コントラクトアドレスを貼り付けてください。Bankr が実際にホストされているチェーンを照合します。

セキュリティ：API キーは非公開にしてください。設定ファイルをバージョン管理にコミットしないでください。失っても問題のない金額だけを取引してください。

すぐにできること：まずポートフォリオ（bankr wallet portfolio）を確認して何ができるかを把握し、次に Base で 5～10 ドルの少額取引を試して、流れに慣れましょう。

プロジェクト管理

エージェントは bankr.bot/terminal/projects で公開 プロジェクトページを作成・管理できます（以前の /agents リンクはこのページにリダイレクトされます）。CLI コマンドは bankr project です。REST パス、JSON フィールド名、ソケットイベントでは、以前の「profile」という表記が引き続き使われます。プロフィールでは、プロジェクトのメタデータ、チーム情報、トークンデータ（チャート＋時価総額）、週間手数料収益、リリース済み製品、Twitter アクティビティフィードに加え、すでに提供したリンクから生成される 2 つのカードを紹介します。GitHub アクティビティは website／製品／チームにリンクされた最初のリポジトリを対象とし、Ethos の信頼性はリンクされた X アカウントを対象とします。tokenChainId は tokenAddress から導出され、入力値としては受け付けられません。

利用条件：プロフィールを作成するには、Bankr を通じてトークンをデプロイ（Doppler または Clanker）するか、そのトークンの手数料受取人になっている必要があります。トークンアドレスは、デプロイ履歴および受取人の記録と照合されます。

プロジェクトのライフサイクル

Bankr を通じてトークンをデプロイします（必須の前提条件）
トークンアドレスを指定して、CLI または REST API 経由でプロフィールを作成します
メタデータ（チーム、製品、収益源）を追加します
管理者の承認 — プロフィールは approved: false で作成され、管理者の承認後に公開されます
維持 — プロジェクトの更新を投稿し、製品や収益源を最新の状態に保ちます

CLI コマンド

bankr project                     # View own project page
bankr project create              # Interactive creation wizard
bankr project create --name "My Agent" --token 0x... --twitter myagent
bankr project update --description "Updated description"
bankr project delete              # Delete own project page (with confirmation)
bankr project add-update          # Add a project update
bankr project add-update --title "v2 Launch" --content "Shipped new features"

すべてのコマンドで、構造化出力（プログラムからの利用が可能）を有効にする --json を使用できます。

REST API エンドポイント

すべてのエンドポイントで、X-API-Key ヘッダーによる API キー認証が必要です。

Method	Path	Description
`GET`	`/agent/profile`	自分のプロフィールを取得
`POST`	`/agent/profile`	プロフィールを作成
`PUT`	`/agent/profile`	プロフィールのフィールドを更新
`DELETE`	`/agent/profile`	自分のプロフィールを削除
`POST`	`/agent/profile/update`	プロジェクトの更新を追加
`GET`	`/agent/profile/token-eligibility?address=0x…`	保存前にトークンをリンクできるか確認

これらは単一プロフィール形式です。1 つのウォレットが複数のプロジェクトを保有する場合があります。?multi=true を指定すると、GET は配列を返し、POST で追加のプロフィールを作成できます（指定しない場合、2 回目の POST は 409 になります）。また、書き込み操作ではスラッグを任意で指定できます — PUT|DELETE /agent/profile/{slug}、POST /agent/profile/{slug}/update。

プロフィールを作成する：

curl -X POST "https://api.bankr.bot/agent/profile" \
  -H "X-API-Key: $BANKR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"projectName": "My Agent", "tokenAddress": "0x...", "description": "An AI trading agent"}'

プロジェクトの更新を追加する：

curl -X POST "https://api.bankr.bot/agent/profile/update" \
  -H "X-API-Key: $BANKR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "v2 Launch", "content": "Shipped swap optimization and new UI"}'

統合ガイドの全容については、references/projects.md を参照してください。

Markdown 対応

ログインしてコメント

基本情報

作者: bankrbot
リポジトリ: bankrbot/skills
カテゴリ: その他
インストール数: 1,132
GitHub スター: 1,208

問題を報告

bankr

bankr について

主な機能

活用シーン

インストール

同梱ファイル

詳細

Bankr

API キーの取得

オプション 1：Bankr CLI（推奨）

インストール

初回セットアップ

ヘッドレスメールログイン（エージェント向けの推奨方法）

ログインオプションのリファレンス

既存の API キーでログインする

LLM ゲートウェイ専用キー（任意）

セットアップを確認する

オプション 2：REST API（直接利用）

機械可読仕様（OpenAPI）

認証

簡単な例：送信 → ポーリング → 完了

会話スレッド

API エンドポイントの概要

ウォレット API（/wallet/*）— 直接エンドポイント（同期）

受取人とユーザーの検索ヘルパー（公開、認証不要）

Agent API（/agent/*）— AI 搭載エンドポイント（非同期）

パブリックエンドポイント（認証不要）

廃止された旧エンドポイント

CLI コマンドリファレンス（v0.3.x）

bankr wallet — ウォレット操作

bankr agent — AI エージェント操作

bankr project — プロジェクトページ

bankr tokens — トークンの検索

bankr files — ファイルストレージ

bankr club — Bankr Club メンバーシップ

認証と設定のコマンド

非対話モード

非推奨のエイリアス

環境変数

LLM ゲートウェイのコマンド

基本的な使い方

シンプルなクエリ

対話型プロンプト

会話スレッド

手動でのジョブ制御

LLM ゲートウェイ

主な概念

プライバシーティア

Max Mode — エージェントのモデルを選択する

クイックコマンド

エージェントのクレジット追加

モデルの非推奨化

機能の概要

取引操作

ポートフォリオ管理

市場調査

送金

NFT 操作

オンチェーン報酬キャンペーン（Merkl）

Polymarketでのベッティング

レバレッジ取引

トークン化株式の取引

トークンのデプロイ

自動化

x402 有料 API 呼び出し

ウェブ閲覧

ファイルストレージ

Bankr について質問する

スキルでエージェントを拡張する

任意のトランザクション

対応チェーン

安全性とアクセス制御

ウォレットレベルのセキュリティ（bankr.bot → セキュリティ）

時限ウィンドウ（自動復元）

保護対象トークンのスワップガード

偽装トークンのスクリーニング

BNKR ステーキングは引き出し専用

API キーレベルの制御（bankr.bot/api-keys）

インシデント対応

一般

ウォレット API（`/wallet/*`）— 直接エンドポイント（同期）

Agent API（`/agent/*`）— AI 搭載エンドポイント（非同期）

`bankr wallet` — ウォレット操作

`bankr agent` — AI エージェント操作

`bankr project` — プロジェクトページ

`bankr tokens` — トークンの検索

`bankr files` — ファイルストレージ

`bankr club` — Bankr Club メンバーシップ