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.
Godkendelse
Sektion kaldt “Godkendelse”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.
Scopes
Sektion kaldt “Scopes”| Scope | Åbner |
|---|---|
kurv:stats:read | De 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.
Endpoints
Sektion kaldt “Endpoints”| Forespørgsel | Svarer 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/seats | De 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/testers | Alle, 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.
Ét eksempel på hver
Sektion kaldt “Ét eksempel på hver”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 }Grænser og friskhed
Sektion kaldt “Grænser og friskhed”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.
Det kan en nøgle ikke
Sektion kaldt “Det kan en nøgle ikke”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. .