KURV データ API

データ API は、エージェントやダッシュボードが KURV について知りたいことに答えます。いくつのコレクションがローンチされたか、何がミントされたか、何が動いたか、登録はどこから来たか。読み取り専用です。キーが開くのは /api/v1 の下にある GET ルートだけで、ほかには何もありません。ここにあるルートは、何も作らず、変えず、署名せず、使いません。

認証

すべてのリクエストは、API キーをベアラートークンとして運びます。

Authorization: Bearer kurv_sk_...

キーは KURV チームがエージェントごとに 1 つ作り、作成時に一度だけ表示されます。KURV が保持するのはダイジェストだけなので、失くしたキーは再発行され、復元はされません。キーはいつでも取り消せ、取り消し後の次のリクエストは拒否されます。キーがない、取り消されたキー、ルートのスコープを持たないキーのリクエストには、そう告げる一文とともに 401 か 403 が返ります。

スコープ

スコープ	開くもの
kurv:stats:read	4 つの /api/v1/stats/* ルート。件数、取引量、手数料、流入元。どの回答にもメールアドレスや名前は含まれません
kurv:admin:read	/api/v1/admin/*。メールアドレス付きの応募、招待を受け入れた人、各コレクションの作成者、使われた枠、毎日のエクスポート、流入元ごとの件数

キーはどちらか一方、または両方のスコープを持ちます。メールアドレスを運ぶのは管理スコープだけです。

エンドポイント

リクエスト	回答
GET /api/v1/stats/overview?chain=	ローンチされたコレクション、ミント、ユニークなミント者、取引量、手数料、クリエイター、登録。それぞれ直近 24 時間、直近 7 日間、全期間
GET /api/v1/stats/collections?chain=&sort=volume|mints|new&cursor=	ローンチされたすべてのコレクション。total_minted、コインごとの取引量、最後のミント、クリエイターのアカウント。1 ページ 25 件
GET /api/v1/stats/mints?chain=&since=&cursor=	新しい順のミント。1 ページ 50 件、since 以降
GET /api/v1/stats/users?chain=&since=	登録、ネットワークごとのアカウント、アクティブなクリエイターとミント者、流入元タグごとの内訳、登録からローンチまでのファネル
GET /api/v1/admin/signups?since=&source=	応募、アカウント、受け入れ状況付きの招待リンク、流入元ごとの件数、タグなしでローンチされたコレクション
GET /api/v1/admin/acceptances?since=&source=	受け入れられた招待のすべて、新しい順。アカウント、プロフィール、X のハンドル、応募に記載があればメールアドレス、時刻、到着時のタグ
GET /api/v1/admin/creators?chain=&since=	各ネットワーク、または chain で指定したネットワークの各コレクションの作成者。アカウント、プロフィール、ハンドル、わかる場合は X のハンドル
GET /api/v1/admin/seats	これまでに使われた枠を日ごとに
GET /api/v1/admin/funnel?chain=&since=	1 つのネットワークで受け入れられた招待を期間別・タグ別に、ファネルとあわせて
GET /api/v1/admin/testers	入場した全員とガイドでレポートした全員、各タスクの状況つき。メモは含みません
GET /api/v1/admin/export?day=	グアヤキル時間で毎日午前 6:30に書き込まれるエクスポート。その日のもの、または最新のものを、存在する日付とあわせて。受け入れ、作成者、枠を含みます。実行時点まで完全です

chain は、このデプロイが提供するネットワークを 1 つ指します。base-sepolia（またはそのチェーン ID 84532）か solana-devnet です。省略すると既定の EVM チェーンになります。since は ISO 8601 か unix 秒です。cursor は前のページの pagination.next_cursor で、中身は不透明、最後のページでは null です。

受け入れ、作成者、エクスポートでは、email_basis がその行のメールアドレスの種類を示します。founder_tagged_link の email は確認済みです。KURV チームが 1 人のためにリンクにタグを付け、1 回使われ、1 件の応募がそのタグを持っています。ref_tag_unverified の email_claimed は申告であり、本人確認ではありません。アカウントは ref タグ付きのアドレスから来て、1 件の応募がそのタグを持っていますが、そのアドレスは誰でも入力できます。2026年10月30日より前のタグはどちらも与えず、フォームに入力されたハンドルも同様です。

すべての回答は api_version、chain、environment、read_at を運びます。金額は最小単位の十進文字列で、native の下にコインごとに 1 項目ずつ並びます。usd は USDC 分をドルで表したもので、ドル換算のないコインしか動いていない場合は null です。あるコインの金額が別のコインの金額と足し合わされることはありません。

それぞれの例を 1 つずつ

curl -H "Authorization: Bearer $KURV_KEY" \
  "https://testnet.kurv.fun/api/v1/stats/overview?chain=base-sepolia"

{ "api_version": "1", "chain": "base-sepolia", "read_at": "2026-10-25T18:02:11.000Z",
  "windows": { "24h": { "collections": { "created": 3, "drafts": 2, "launched": 1 }, "mints": { "events": 12, "pieces": 12 },
    "unique_minters": 9, "volume": { "native": [{ "asset_id": "evm:84532:token:0x036c...", "symbol": "USDC", "decimals": 6, "base_units": "48000000" }], "usd": "48.00" },
    "fees": { "native": [{ "asset_id": "evm:84532:token:0x036c...", "symbol": "USDC", "decimals": 6, "base_units": "2400000" }], "usd": "2.40" },
    "creators": 1, "signups": 3 }, "7d": { }, "all": { } },
  "notes": [ ] }

curl -H "Authorization: Bearer $KURV_KEY" \
  "https://testnet.kurv.fun/api/v1/stats/collections?chain=base-sepolia&sort=volume"

{ "sort": "volume", "collections": [ { "id": "evm:84532:0xabc...", "address": "0xabc...", "name": "MAXCAT", "creator": "0x2787...",
    "launched_at": "2026-10-20T15:00:00.000Z", "total_minted": 120, "volume": { "native": [ ], "usd": "600.00" }, "last_mint_at": "2026-10-25T17:40:02.000Z" } ],
  "pagination": { "limit": 25, "next_cursor": null, "total": 1 } }

curl -H "Authorization: Bearer $KURV_KEY" \
  "https://testnet.kurv.fun/api/v1/stats/mints?chain=base-sepolia&since=2026-10-25T17:00:00Z"

{ "since": "2026-10-25T17:00:00.000Z", "mints": [ { "id": "evm:84532:0xabc...:4200100:3", "collection": "evm:84532:0xabc...", "minter": "0x70997...",
    "pieces": 1, "paid": { "symbol": "USDC", "decimals": 6, "base_units": "5000000" }, "tx": "0x5e2b...", "at": "2026-10-25T17:40:02.000Z" } ],
  "pagination": { "limit": 50, "next_cursor": null } }

curl -H "Authorization: Bearer $KURV_KEY" \
  "https://testnet.kurv.fun/api/v1/stats/users?chain=base-sepolia"

{ "accounts": { "base_sepolia": 34, "solana_devnet": 6 },
  "windows": { "7d": { "signups": 5, "active_creators": 2, "active_minters": 9, "by_source": { "XD-ana": { "signups": 2, "accounts": 1, "launched": 1 } },
    "funnel": { "visits": 40, "submissions": 5, "building": 3, "launched": 2 } } },
  "notes": [ "Visits, sign-ups and the wizard are not per network." ] }

curl -H "Authorization: Bearer $KURV_ADMIN_KEY" \
  "https://testnet.kurv.fun/api/v1/admin/signups?since=2026-10-01&source=XD-ana"

{ "applications": [ { "handle": "ana_builds", "email": "[email protected]", "created_at": "2026-10-24T09:12:00.000Z", "ref": "XD-ana" } ],
  "accounts": { "base_sepolia": 34, "solana_devnet": 6 },
  "invites": [ { "link_id": "3f9c...", "label": "Friends on X", "uses": 12,
    "redemptions": [ { "account": "0x3c44...", "handle": "ana_builds", "accepted_at": "2026-10-24T10:01:00.000Z", "ref": "XD-ana" } ] } ],
  "by_source": { "XD-ana": { "signups": 2, "accepted": 1, "launched": 1 } },
  "launched_outside_outreach": 7 }

制限と鮮度

各キーは 1 分あたり 120 リクエスト、/api/v1/admin/* では 1 分あたり 30 リクエストまで送れます。それを超えると、retry-after ヘッダー付きの 429 が返ります。すべての回答は最長でも 60 秒前のものです。サーバーは 1 分に一度読み取り、read_at はその読み取りの時刻です。ミントを発生順に追うには、最後に見た read_at を since に入れて /api/v1/stats/mints を 30 秒から 60 秒ごとに呼んでください。開いたままにするストリームはありません。

キーにできないこと

何もできません。キーは読むだけです。コレクションを作ることも、ローンチを準備することも、ミントも、取引も、プロフィールの変更も、招待に触れることもできません。コレクションを作るべきエージェントは、代わりに本人の承認のもとで MCP を通じて接続します。その接続はどのキーとも別物です。

エラーは { "api_version": "1", "error": { "code": "...", "message": "..." } } の形で、ステータスコードは 400、401、403、429、503 のいずれかです。キー不要の公開ルートは 公開 API に、すべての入口は KURV for Developers にあります。 これらの数字に含まれる手数料は各コレクション自身のものです。手数料 と リスクと免責事項 をお読みください。