Gå til innholdet
Åpne appen

KURVs data-API

Data-API-et svarer på spørsmålene en agent eller en oversikt stiller om KURV: hvor mange samlinger som er lansert, hva som er mintet, hva som har beveget seg, og hvor registreringene kom fra. Det kan bare leses. En nøkkel åpner bare GET-rutene under /api/v1 og ingenting annet: ingen rute her lager, endrer, signerer eller bruker noe.

Hver forespørsel har med en API-nøkkel som bærertoken:

Authorization: Bearer kurv_sk_...

Nøkler lages av KURV-teamet, én per agent, og vises én gang når de lages. KURV beholder bare et sammendrag, så en mistet nøkkel erstattes, den gjenopprettes aldri. En nøkkel kan trekkes tilbake når som helst; neste forespørsel med den blir avvist. Forespørsler uten nøkkel, med en tilbaketrukket nøkkel eller med en nøkkel som mangler rutens tilgangsområde, får 401 eller 403 med én setning som sier det.

TilgangsområdeÅpner
kurv:stats:readDe fire /api/v1/stats/*-rutene: antall, volum, gebyrer og kilder, uten e-post og uten navn i noe svar
kurv:admin:read/api/v1/admin/*: søknader med e-postadressene sine, hvem som godtok en invitasjon, skaperen bak hver samling, brukte plasser, den daglige eksporten og antallet etter kilde

En nøkkel har ett tilgangsområde eller begge. Admin-området er det eneste som har med e-postadresser.

ForespørselSvarer med
GET /api/v1/stats/overview?chain=Lanserte samlinger, mints, unike mintere, volum, gebyrer, skapere og registreringer, hver for de siste 24 timene, de siste 7 dagene og hele tiden
GET /api/v1/stats/collections?chain=&sort=volume|mints|new&cursor=Hver lanserte samling med total_minted, volumet etter mynt, siste mint og skaperkontoen, 25 per side
GET /api/v1/stats/mints?chain=&since=&cursor=Mints med de nyeste først, 50 per side, fra since og fremover
GET /api/v1/stats/users?chain=&since=Registreringer, kontoer per nettverk, aktive skapere og mintere, fordelingen etter kildetagg, og trakten fra registrering til lansering
GET /api/v1/admin/signups?since=&source=Søknader, kontoer, invitasjonslenker med innløsningene sine, antall etter kilde, og lanseringer uten tagg
GET /api/v1/admin/acceptances?since=&source=Hver godtatte invitasjon, de nyeste først: kontoen, profilen, X-brukernavnet, en e-postadresse der en søknad oppgir en, tidspunktet og taggen den kom med
GET /api/v1/admin/creators?chain=&since=Skaperen bak hver samling på hvert nettverk, eller på det ene chain oppgir: kontoen, profilen, brukernavnet og X-brukernavnet når det er kjent
GET /api/v1/admin/seatsPlassene som er brukt så langt, dag for dag
GET /api/v1/admin/funnel?chain=&since=Godtatte invitasjoner på ett nettverk, per vindu og etter tagg, og trakten med dem
GET /api/v1/admin/testersAlle som er sluppet inn og alle som har rapportert i testerveiledningen, med hvor hver av oppgavene deres står. Notatene deres holdes utenfor
GET /api/v1/admin/export?day=Eksporten som skrives hver dag kl. 6:30 AM i Guayaquil, for den dagen eller den nyeste, med dagene som finnes: godkjenningene, skaperne og plassene, komplett frem til øyeblikket den ble kjørt

chain oppgir ett nettverk utrullingen betjener, base-sepolia (eller kjede-ID-en, 84532) eller solana-devnet; utelatt er det standard EVM-kjede. since er ISO 8601 eller unix-sekunder. cursor er pagination.next_cursor fra forrige side, ugjennomsiktig, og null på siste side.

I godkjenninger, skapere og eksporten sier email_basis hva slags e-postadresse en rad har. email med founder_tagged_link er verifisert: KURV-teamet tagget lenken for én person, den ble brukt én gang, og én søknad har taggen. email_claimed med ref_tag_unverified er en påstand og aldri en identitet: kontoen kom fra en adresse med en ref-tagg, og én søknad har den taggen, men hvem som helst kan skrive en slik adresse. Tagger fra før 30. oktober 2026 gir ingen av dem, og et brukernavn skrevet inn i et skjema gir ingen av dem.

Hvert svar har med api_version, chain, environment og read_at. Beløp er basisenheter som desimale strenger, én oppføring per mynt under native; usd er USDC-delen i dollar, eller null når bare en mynt uten dollartall har beveget seg. Penger i én mynt legges aldri sammen med penger i en annen.

Terminal window
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": [ ] }
Terminal window
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 } }
Terminal window
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 } }
Terminal window
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." ] }
Terminal window
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 }

Hver nøkkel kan gjøre 120 forespørsler i minuttet, og 30 i minuttet på /api/v1/admin/*. Over det er svaret 429 med en retry-after-header. Hvert svar er høyst 60 sekunder gammelt: serveren leser én gang i minuttet, og read_at er tidspunktet for den lesingen. For å følge mints mens de skjer, kaller du /api/v1/stats/mints hvert 30. til 60. sekund med since satt til siste read_at du så; det finnes ingen strøm å holde åpen.

Ingenting. En nøkkel leser. Den kan ikke lage en samling, forberede en lansering, minte, handle, endre en profil eller røre en invitasjon. En agent som skal bygge samlinger, kobler seg i stedet til gjennom MCP, med personens godkjenning, og den koblingen er atskilt fra enhver nøkkel.

Feil bruker { "api_version": "1", "error": { "code": "...", "message": "..." } } med statuskodene 400, 401, 403, 429 eller 503. De offentlige rutene uten nøkkel er beskrevet i Offentlige API-er; KURV for utviklere viser hver inngang. Gebyrene i disse tallene er hver samlings egne: les Gebyrer og Risikoer og ansvarsfraskrivelse.

Ingenting her er økonomisk rådgivning. Les Risikoer og ansvarsfraskrivelse før du minter, kjøper eller selger tilbake til Vault. Tilbake til kurv.fun. Personvernerklæring. Vilkår for bruk. .