KURVs data-API
Data-API:et svarar på frågorna som en agent eller en översikt ställer om KURV: hur många samlingar som lanserades, vad som mintades, vad som rörde sig, var registreringarna kom ifrån. Det är bara för läsning. En nyckel öppnar bara GET-rutterna under /api/v1 och inget annat: ingen rutt här skapar, ändrar, signerar eller spenderar något.
Autentisering
Section titled “Autentisering”Varje förfrågan bär en API-nyckel som bearer-token:
Authorization: Bearer kurv_sk_...Nycklar skapas av KURV-teamet, en per agent, och visas en gång när de skapas. KURV sparar bara en hash, så en förlorad nyckel ersätts, den återställs aldrig. En nyckel kan återkallas när som helst; dess nästa förfrågan nekas. Förfrågningar utan nyckel, med en återkallad nyckel eller med en nyckel som saknar ruttens behörighet får 401 eller 403 med en mening som säger det.
Behörigheter
Section titled “Behörigheter”| Behörighet | Öppnar |
|---|---|
kurv:stats:read | De fyra /api/v1/stats/*-rutterna: antal, volym, avgifter och källor, utan e-post och utan namn i något svar |
kurv:admin:read | /api/v1/admin/*: ansökningar med sina e-postadresser, vem som tog emot en inbjudan, skaparen bakom varje samling, använda platser, den dagliga exporten och antal per källa |
En nyckel bär en behörighet eller båda. Admin-behörigheten är den enda som bär e-postadresser.
Slutpunkter
Section titled “Slutpunkter”| Förfrågan | Svarar med |
|---|---|
GET /api/v1/stats/overview?chain= | Lanserade samlingar, mintar, unika mintare, volym, avgifter, skapare och registreringar, var och en för de senaste 24 timmarna, de senaste 7 dagarna och all tid |
GET /api/v1/stats/collections?chain=&sort=volume|mints|new&cursor= | Varje lanserad samling med total_minted, dess volym per mynt, dess senaste mint och dess skaparkonto, 25 per sida |
GET /api/v1/stats/mints?chain=&since=&cursor= | Mintar med de nyaste först, 50 per sida, från since och framåt |
GET /api/v1/stats/users?chain=&since= | Registreringar, konton per nätverk, aktiva skapare och mintare, uppdelningen per källtagg, och tratten från registrering till lansering |
GET /api/v1/admin/signups?since=&source= | Ansökningar, konton, inbjudningslänkar med sina inlösningar, antal per källa, och lanseringar som inte bar någon tagg |
GET /api/v1/admin/acceptances?since=&source= | Varje mottagen inbjudan, de nyaste först: kontot, dess profil, dess X-namn, en e-postadress där en ansökan anger en, tiden och taggen den kom med |
GET /api/v1/admin/creators?chain=&since= | Skaparen bakom varje samling på varje nätverk, eller på det som chain anger: kontot, dess profil, dess användarnamn och dess X-namn när det är känt |
GET /api/v1/admin/seats | Platserna som använts hittills, dag för dag |
GET /api/v1/admin/funnel?chain=&since= | Mottagna inbjudningar på ett nätverk, per fönster och per tagg, och tratten med dem |
GET /api/v1/admin/testers | Alla som släppts in och alla som rapporterat i testarguiden, med var var och en av deras uppgifter står. Deras anteckningar hålls utanför |
GET /api/v1/admin/export?day= | Exporten som skrivs varje dag kl. 6:30 på morgonen i Guayaquil, den dagens eller den nyaste, med de dagar som finns: mottagandena, skaparna och platserna, kompletta fram till ögonblicket den kördes |
chain anger ett nätverk som driftsättningen betjänar, base-sepolia (eller dess kedje-ID, 84532) eller solana-devnet; utelämnad är det standardkedjan för EVM. since är ISO 8601 eller unix-sekunder. cursor är föregående sidas pagination.next_cursor, ogenomskinlig, och null på sista sidan.
I mottaganden, skapare och exporten anger email_basis vilken sorts e-postadress en rad bär. email med founder_tagged_link är verifierad: KURV-teamet taggade länken för en person, den användes en gång och en ansökan bär taggen. email_claimed med ref_tag_unverified är ett påstående och aldrig en identitet: kontot kom från en adress med en ref-tagg, och en ansökan bär den taggen, men vem som helst kan skriva en sådan adress. Taggar från före 30 oktober 2026 ger ingetdera, och ett användarnamn som skrivits in i ett formulär ger ingetdera.
Varje svar bär api_version, chain, environment och read_at. Belopp är basenheter som decimala strängar, en post per mynt under native; usd är USDC-delen i dollar, eller null när bara ett mynt utan dollarbelopp rörde sig. Pengar i ett mynt läggs aldrig ihop med pengar i ett annat.
Ett exempel på varje
Section titled “Ett exempel på varje”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 och aktualitet
Section titled “Gränser och aktualitet”Varje nyckel får göra 120 förfrågningar per minut, och 30 per minut på /api/v1/admin/*. Över det blir svaret 429 med en retry-after-header. Varje svar är högst 60 sekunder gammalt: servern läser en gång i minuten och read_at är tiden för den läsningen. För att följa mintar när de sker anropar du /api/v1/stats/mints var 30:e till 60:e sekund med since satt till den senaste read_at du såg; det finns ingen ström att hålla öppen.
Det här kan en nyckel inte göra
Section titled “Det här kan en nyckel inte göra”Ingenting. En nyckel läser. Den kan inte skapa en samling, förbereda en lansering, minta, handla, ändra en profil eller röra en inbjudan. En agent som ska bygga samlingar ansluter i stället via MCP, med personens godkännande, och den anslutningen är skild från varje nyckel.
Fel använder { "api_version": "1", "error": { "code": "...", "message": "..." } } med statuskoderna 400, 401, 403, 429 eller 503. De publika rutterna utan nyckel beskrivs i Publika API:er; KURV för utvecklare listar varje ingång. Avgifterna i de här siffrorna är varje samlings egna: läs Avgifter och Risker och ansvarsfriskrivning.
Inget här är finansiell rådgivning. Läs Risker och ansvarsfriskrivning innan du mintar, köper eller säljer tillbaka till Vault. Tillbaka till kurv.fun. Integritetspolicy. Användarvillkor. .