跳到內容
開啟應用程式

KURV 數據 API

數據 API 回答代理或儀表板想知道的 KURV 問題:發行了多少系列、鑄造了什麼、有哪些資金流動、註冊來自哪裡。它是唯讀的。一把金鑰只開放 /api/v1 底下的 GET 路由,其他一律不開:這裡沒有任何路由會建立、變更、簽署或花費任何東西。

每個請求都把 API 金鑰當作 bearer 權杖帶上:

Authorization: Bearer kurv_sk_...

金鑰由 KURV 團隊建立,每個代理一把,只在建立時顯示一次。KURV 只保存摘要,所以遺失的金鑰只能更換,無法找回。金鑰隨時可以撤銷;撤銷後的下一個請求就會被拒絕。沒有金鑰、使用已撤銷的金鑰,或金鑰缺少該路由權限範圍的請求,會收到 401 或 403,並附上一句說明。

權限範圍開放
kurv:stats:read四條 /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、依代幣區分的成交量、最近一次鑄造和創作者帳戶,每頁 25 筆
GET /api/v1/stats/mints?chain=&since=&cursor=鑄造紀錄,最新的在前,每頁 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=某個網路上已接受的邀請,依時段和標籤列出,並附上對應的漏斗
GET /api/v1/admin/testers所有被放行的人,以及所有在試用指南上回報過的人,附上他們每項任務目前的狀態。他們的筆記不包含在內
GET /api/v1/admin/export?day=每天瓜亞基爾時間上午 6:30 寫入的匯出,可取那一天的或最新的,並列出有哪些日期:接受紀錄、創作者和名額,完整到執行的那一刻

chain 指定這個部署提供的一個網路:base-sepolia(或它的鏈 ID 84532)或 solana-devnet;省略時就是預設的 EVM 鏈。since 是 ISO 8601 或 unix 秒數。cursor 是上一頁的 pagination.next_cursor,內容不透明,最後一頁為 null。

在接受紀錄、創作者和匯出中,email_basis 說明這一列帶的是哪種電子郵件。帶 founder_tagged_link 的 email 已經過驗證:KURV 團隊為某一個人的連結加上標籤,這個連結只用過一次,而且有一份申請帶著這個標籤。帶 ref_tag_unverified 的 email_claimed 只是自稱,絕不代表身分:帳戶來自帶有 ref 標籤的網址,也有一份申請帶著這個標籤,但任何人都能輸入這樣的網址。2026 年 10 月 30 日之前的標籤兩種都不會給,在表單裡輸入的帳號名稱也兩種都不會給。

每個回應都帶有 api_version、chain、environment 和 read_at。金額是以基本單位表示的十進位字串,native 底下每種代幣一筆;usd 是 USDC 部分換算成的美元,如果只有沒有美元價格的代幣有流動,就是 null。一種代幣的金額永遠不會和另一種代幣的金額相加。

終端機視窗
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 }

每把金鑰每分鐘可以發出 120 個請求,在 /api/v1/admin/* 上則是每分鐘 30 個。超過之後,回應會是帶有 retry-after 標頭的 429。每個回應最多只會是 60 秒前的資料:伺服器每分鐘讀取一次,read_at 就是那次讀取的時間。想要即時追蹤鑄造,請每 30 到 60 秒呼叫一次 /api/v1/stats/mints,並把 since 設成你上次看到的 read_at;這裡沒有需要保持開啟的串流。

什麼都不能做。金鑰只能讀取。它不能建立系列、準備發行、鑄造、交易、修改個人檔案,也不能碰任何邀請。需要建立系列的代理,應該改為在本人核准下透過 MCP 連線,而那個連線和任何金鑰都無關。

錯誤使用 { "api_version": "1", "error": { "code": "...", "message": "..." } } 格式,狀態碼為 400、401、403、429 或 503。不需要金鑰的公開路由請見公開 API;KURV 開發者列出了所有入口。這些數據中的手續費是每個系列自己的費用:請閱讀費用和風險與免責聲明。

此處內容均不構成財務建議。在鑄造、購買或賣回之前,請先閱讀風險與免責聲明。返回 kurv.fun。隱私權政策。使用條款。 。