Admin APIs の紹介

最終更新日: 2026年8月26日1分で読めます

ダッシュボードは単一のアプリを管理する分には十分機能します。しかし、顧客ごと、パートナーごと、環境ごとに専用アプリを用意してAlchemyを大規模に運用しているチームでは、作業が繰り返しになりがちです。同じ作成フロー、allowlistの更新、使用量チェックを何度もクリックすることになります。

そこで、ビルダーの作業をよりシンプルにするために、2つのAdmin APIを公開します。

Apps Management API: アプリの作成、設定、削除、allowlistの管理を行います。
Usage API: ダッシュボードのUsageタブと同じ使用量データを取得できます。

どちらのAPIも、1つのエンドポイントと1つのAccess Keyでアクセスできます。ダッシュボードのSettings → SecurityからApp ManagementまたはUsageにスコープしたAccess Keyを取得し、https://admin-api.alchemy.com/v1に向けて使用してください。

Apps Management API

Apps Management APIは、これまでダッシュボード上で手作業で行っていたCRUD処理、つまりアプリの作成、ネットワークallowlistの設定、アドレス・ドメイン・IPのallowlist管理を扱います。

bashCopied
curl -X POST 'https://admin-api.alchemy.com/v1/apps' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your access key}' \
--data '{
  "name": "app-tenant-42",
  "networkAllowlist": ["ETH_MAINNET"],
  "products": ["node-api"]
}'

これにより、顧客ごとに専用アプリをプロビジョニングするプラットフォーム、パートナーやノードオペレーターごとに使用量を分離するために個別のアプリを渡すチーム、環境ごとに新しいアプリを立ち上げるパイプラインなどでの手作業が不要になります。Access Keyはそれぞれ独自のスコープ、有効期限、ローテーションを持つため、アプリのプロビジョニングをダッシュボード限定の作業ではなく、CI/CDの一部として組み込むことができます。

Usage API

Usage APIは、これまでダッシュボードのUsageタブから取得していた数値を提供する読み取り専用エンドポイントです。全体および各ネットワークごとのCU合計、月初来の集計に加え、有料プランでは、HTTP・WebSocket・webhookトラフィックにわたるアプリ別・メソッド別・ネットワーク別の内訳、ドル換算の使用量、リクエスト数も取得できます。

bash

Copied

curl 'https://admin-api.alchemy.com/v1/usage/summary' \
--header 'Authorization: Bearer {your access key}'

履歴と詳細度は、利用しているプランに応じて異なります。

Plan	What's included
Free	High-level CU summary, 1 day of history
PAYG	Full breakdown, 7 days of history
Enterprise	Full breakdown, 30 days of history

認証には、bearerトークンとしてどちらかの資格情報を使用できます。チーム全体の数値が必要な場合は読み取り専用のUsageにスコープしたAccess Key、1つのアプリの数値だけが必要な場合は既存のアプリスコープのAPIキーを同じ方法で送信してください。

はじめに

Securityタブから Access Key を作成し、必要な権限にスコープを設定した上で、https://admin-api.alchemy.com/v1を呼び出してください。

ドキュメントを参照するか、ご質問や大規模運用における専用ソリューションについてはチームまでお問い合わせください。

FAQ

Apps ManagementとUsageの違いは何ですか?

Apps Managementはアプリの作成と設定、すなわち名前、ネットワークallowlist、アドレス・ドメイン・IPのallowlistを扱います。Usageは読み取り専用で、compute unit合計を返し、有料プランでは時系列の内訳も返します。Access Keyは必要な権限だけにスコープしてください。

Admin APIへの認証方法は?

ダッシュボードのSecurityタブでAccess Keyを作成し、App ManagementおよびUsageを有効にした上で、Authorization: Bearer {your access key}としてhttps://admin-api.alchemy.com/v1に送信してください。