Přeskočit na obsah
Otevřít aplikaci

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í.

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í.

RozsahOteví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.

PožadavekOdpoví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/seatsDosud 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/testersVš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”
Terminál
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": [ ] }
Terminál
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 } }
Terminál
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 } }
Terminál
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." ] }
Terminál
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 }

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.

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í. .