Gå til indhold
Åbn appen

KURVs data-API

Data-API’et svarer på de spørgsmål, en agent eller en oversigt stiller om KURV: hvor mange samlinger der blev lanceret, hvad der blev mintet, hvad der blev handlet, og hvor tilmeldingerne kom fra. Det kan kun læse. En nøgle åbner kun GET-ruterne under /api/v1 og intet andet: ingen rute her opretter, ændrer, signerer eller bruger noget.

Hver forespørgsel har en API-nøgle med som bearer-token:

Authorization: Bearer kurv_sk_...

Nøgler laves af KURV-teamet, én pr. agent, og vises én gang, når de laves. KURV gemmer kun et digest, så en mistet nøgle bliver erstattet, aldrig gendannet. En nøgle kan til enhver tid tilbagekaldes; dens næste forespørgsel bliver afvist. Forespørgsler uden nøgle, med en tilbagekaldt nøgle eller med en nøgle, der mangler rutens scope, får en 401 eller 403 med én sætning, der siger det.

ScopeÅbner
kurv:stats:readDe fire /api/v1/stats/*-ruter: antal, volumen, gebyrer og kilder, uden e-mail og uden navn i noget svar
kurv:admin:read/api/v1/admin/*: ansøgninger med deres e-mails, hvem der tog imod en invitation, skaberen bag hver samling, de brugte pladser, den daglige eksport og antal efter kilde

En nøgle har ét scope eller begge. Admin-scopet er det eneste, der har e-mails.

ForespørgselSvarer med
GET /api/v1/stats/overview?chain=Lancerede samlinger, mints, unikke mintere, volumen, gebyrer, skabere og tilmeldinger, hver for de sidste 24 timer, de sidste 7 dage og hele tiden
GET /api/v1/stats/collections?chain=&sort=volume|mints|new&cursor=Hver lanceret samling med total_minted, dens volumen pr. mønt, dens seneste mint og dens skaberkonto, 25 pr. side
GET /api/v1/stats/mints?chain=&since=&cursor=Mints med de nyeste først, 50 pr. side, fra since og frem
GET /api/v1/stats/users?chain=&since=Tilmeldinger, konti pr. netværk, aktive skabere og mintere, fordelingen efter kildetag og tragten fra tilmelding til lancering
GET /api/v1/admin/signups?since=&source=Ansøgninger, konti, invitationslinks med deres indløsninger, antal efter kilde og lanceringer uden tag
GET /api/v1/admin/acceptances?since=&source=Hver accepteret invitation, nyeste først: kontoen, dens profil, dens X-brugernavn, en e-mail, hvor en ansøgning angiver en, tidspunktet og det tag, den kom med
GET /api/v1/admin/creators?chain=&since=Skaberen bag hver samling på hvert netværk, eller på det netværk, chain angiver: kontoen, dens profil, dens brugernavn og dens X-brugernavn, når det kendes
GET /api/v1/admin/seatsDe pladser, der er brugt indtil nu, dag for dag
GET /api/v1/admin/funnel?chain=&since=Accepterede invitationer på ét netværk, pr. vindue og efter tag, og tragten med dem
GET /api/v1/admin/testersAlle, der er lukket ind, og alle, der har rapporteret i testerguiden, med hvor hver af deres opgaver står. Deres noter er ikke med
GET /api/v1/admin/export?day=Eksporten, der skrives hver dag kl. 6:30 om morgenen i Guayaquil, for den dag eller den nyeste, med de dage, der findes: accepterne, skaberne og pladserne, komplet frem til det øjeblik, den kørte

chain angiver ét netværk, som udrulningen betjener, base-sepolia (eller dets chain id, 84532) eller solana-devnet; udelades det, er det standard-EVM-kæden. since er ISO 8601 eller unix-sekunder. cursor er den forrige sides pagination.next_cursor, uigennemsigtig, og null på den sidste side.

I accepter, skabere og eksporten fortæller email_basis, hvilken slags e-mail en række har. email med founder_tagged_link er verificeret: KURV-teamet taggede linket til én person, det blev brugt én gang, og én ansøgning har tagget. email_claimed med ref_tag_unverified er en påstand og aldrig en identitet: kontoen kom fra en adresse med et ref-tag, og én ansøgning har det tag, men alle kan skrive sådan en adresse. Tags fra før 30. oktober 2026 giver ingen af delene, og et brugernavn, der er skrevet i en formular, giver ingen af delene.

Hvert svar har api_version, chain, environment og read_at. Beløb er basisenheder som decimale strenge, én post pr. mønt under native; usd er USDC-delen i dollars, eller null, når kun en mønt uden et dollarbeløb blev handlet. Penge i én mønt lægges aldrig sammen med penge i en anden.

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øgle må lave 120 forespørgsler i minuttet og 30 i minuttet på /api/v1/admin/*. Derudover er svaret 429 med en retry-after-header. Hvert svar er højst 60 sekunder gammelt: serveren læser én gang i minuttet, og read_at er tidspunktet for den læsning. For at følge mints, mens de sker, kalder du /api/v1/stats/mints hvert 30. til 60. sekund med since sat til den seneste read_at, du så; der er ingen strøm at holde åben.

Ingenting. En nøgle læser. Den kan ikke oprette en samling, forberede en lancering, minte, handle, ændre en profil eller røre en invitation. En agent, der skal bygge samlinger, forbinder i stedet via MCP, med personens godkendelse, og den forbindelse er adskilt fra enhver nøgle.

Fejl bruger { "api_version": "1", "error": { "code": "...", "message": "..." } } med statuskoderne 400, 401, 403, 429 eller 503. De offentlige ruter uden nøgle er beskrevet i Offentlige API’er; KURV for udviklere viser alle indgange. Gebyrerne i disse tal er hver samlings egne: læs Gebyrer og Risici og ansvarsfraskrivelse.

Intet her er økonomisk rådgivning. Læs Risici og ansvarsfraskrivelse, før du minter, køber eller sælger tilbage til Vault. Tilbage til kurv.fun. Privatlivspolitik. Vilkår for brug. .