Datové API KURV
Datové API odpovídá na otázky, které o KURV klade agent nebo dashboard: kolik kolekcí se spustilo, co se namintovalo, co se pohnulo, odkud přišly registrace. Je jen pro čtení. Klíč otevírá jen trasy GET pod /api/v1 a nic jiného: žádná trasa tady nic nevytváří, nemění, nepodepisuje ani neutrácí.
Ověření
Sekce “Ověření”Každý požadavek nese klíč API jako bearer token:
Authorization: Bearer kurv_sk_...Klíče vytváří tým KURV, jeden pro každého agenta, a ukážou se jen jednou, při vytvoření. KURV si uchovává jen jeho otisk (digest), takže ztracený klíč se nahradí, nikdy neobnoví. Klíč lze kdykoli zrušit; jeho další požadavek bude odmítnut. Požadavky bez klíče, se zrušeným klíčem nebo s klíčem, kterému chybí rozsah dané trasy, dostanou 401 nebo 403 s jednou větou, která to vysvětlí.
Rozsahy
Sekce “Rozsahy”| Rozsah | Otevírá |
|---|---|
kurv:stats:read | Čtyři trasy /api/v1/stats/*: počty, objem, poplatky a zdroje, bez e-mailu a bez jména v jakékoli odpovědi |
kurv:admin:read | /api/v1/admin/*: přihlášky s jejich e-maily, kdo přijal pozvánku, tvůrce za každou kolekcí, obsazená místa, denní export a počty podle zdroje |
Klíč nese jeden rozsah nebo oba. Rozsah admin je jediný, který obsahuje e-maily.
Koncové body
Sekce “Koncové body”| Požadavek | Odpovídá |
|---|---|
GET /api/v1/stats/overview?chain= | Spuštěné kolekce, minty, jedineční minteři, objem, poplatky, tvůrci a registrace, vždy za posledních 24 hodin, posledních 7 dní a celou dobu |
GET /api/v1/stats/collections?chain=&sort=volume|mints|new&cursor= | Každá spuštěná kolekce s total_minted, jejím objemem podle mince, posledním mintem a účtem tvůrce, 25 na stránku |
GET /api/v1/stats/mints?chain=&since=&cursor= | Minty od nejnovějších, 50 na stránku, od since dál |
GET /api/v1/stats/users?chain=&since= | Registrace, účty podle sítě, aktivní tvůrci a minteři, rozpad podle zdrojového tagu a trychtýř od registrace po spuštění |
GET /api/v1/admin/signups?since=&source= | Přihlášky, účty, zvací odkazy s jejich uplatněními, počty podle zdroje a spuštění, která nenesla žádný tag |
GET /api/v1/admin/acceptances?since=&source= | Každá přijatá pozvánka, od nejnovější: účet, jeho profil, jeho účet na X, e-mail, pokud ho nějaká přihláška uvádí, čas a tag, se kterým přišel |
GET /api/v1/admin/creators?chain=&since= | Tvůrce za každou kolekcí v každé síti, nebo v té, kterou uvádí chain: účet, jeho profil, jeho přezdívka a jeho účet na X, pokud je znám |
GET /api/v1/admin/seats | Dosud obsazená místa, den po dni |
GET /api/v1/admin/funnel?chain=&since= | Přijaté pozvánky v jedné síti, podle období a podle tagu, a k nim trychtýř |
GET /api/v1/admin/testers | Všichni vpuštění a všichni, kdo něco nahlásili v průvodci pro testery, se stavem každého jejich úkolu. Jejich poznámky do toho nepatří |
GET /api/v1/admin/export?day= | Export zapisovaný každý den v 6:30 ráno podle času v Guayaquilu, ten z daného dne nebo nejnovější, s dny, které existují: přijetí, tvůrci a místa, kompletní až do chvíle, kdy proběhl |
chain určuje jednu síť, kterou nasazení obsluhuje, base-sepolia (nebo její chain id, 84532) nebo solana-devnet; pokud chybí, je to výchozí EVM blockchain. since je ISO 8601 nebo unixové sekundy. cursor je pagination.next_cursor předchozí stránky, neprůhledný, a na poslední stránce null.
V přijetích, tvůrcích a exportu říká email_basis, jaký druh e-mailu řádek nese. email s founder_tagged_link je ověřený: tým KURV otagoval odkaz pro jednu osobu, byl použit jednou a jedna přihláška nese daný tag. email_claimed s ref_tag_unverified je jen tvrzení, nikdy identita: účet přišel z adresy s tagem ref a jedna přihláška nese tento tag, ale takovou adresu může napsat kdokoli. Tagy před 30. říjnem 2026 nedávají ani jedno a přezdívka napsaná do formuláře také ne.
Každá odpověď nese api_version, chain, environment a read_at. Částky jsou základní jednotky jako desetinné řetězce, jedna položka pro každou minci pod native; usd je část v USDC v dolarech, nebo null, když se pohnula jen mince bez dolarového údaje. Peníze v jedné minci se nikdy nesčítají s penězi v jiné.
Jeden příklad od každého
Sekce “Jeden příklad od každého”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 }Limity a aktuálnost
Sekce “Limity a aktuálnost”Každý klíč smí udělat 120 požadavků za minutu, a 30 za minutu na /api/v1/admin/*. Nad tento limit je odpovědí 429 s hlavičkou retry-after. Každá odpověď je stará nejvýš 60 sekund: server čte jednou za minutu a read_at je čas tohoto čtení. Chceš-li sledovat minty, jak probíhají, volej /api/v1/stats/mints každých 30 až 60 sekund s since nastaveným na poslední read_at, který jsi viděl; žádný stream, který bys musel držet otevřený, neexistuje.
Co klíč neumí
Sekce “Co klíč neumí”Nic. Klíč čte. Neumí vytvořit kolekci, připravit spuštění, mintovat, obchodovat, změnit profil ani sáhnout na pozvánku. Agent, který má stavět kolekce, se místo toho připojí přes MCP, se souhlasem dané osoby, a toto spojení je oddělené od jakéhokoli klíče.
Chyby mají tvar { "api_version": "1", "error": { "code": "...", "message": "..." } } se stavovými kódy 400, 401, 403, 429 nebo 503. Veřejné trasy bez klíče popisuje Veřejná API; KURV pro vývojáře uvádí všechny vstupní body. Poplatky v těchto údajích jsou vlastní poplatky každé kolekce: přečti si Poplatky a Rizika a upozornění.
Nic z toho, co tu najdeš, není finanční poradenství. Než budeš mintovat, kupovat nebo prodávat zpět, přečti si Rizika a upozornění. Zpět na kurv.fun. Zásady ochrany soukromí. Podmínky používání. .