KURV-data-API
Data-API vastaa kysymyksiin, joita agentti tai kojelauta kysyy KURV:ista: kuinka monta kokoelmaa julkaistiin, mitä mintattiin, mikä liikkui ja mistä rekisteröitymiset tulivat. Se on vain luettava. Avain avaa vain GET-reitit polun /api/v1 alla eikä mitään muuta: mikään reitti täällä ei luo, muuta, allekirjoita tai käytä mitään.
Tunnistautuminen
Osio nimeltä “Tunnistautuminen”Jokainen pyyntö kuljettaa API-avainta bearer-tokenina:
Authorization: Bearer kurv_sk_...KURV-tiimi tekee avaimet, yhden kullekin agentille, ja näyttää ne kerran, kun ne tehdään. KURV säilyttää vain tiivisteen, joten kadonnut avain korvataan, sitä ei koskaan palauteta. Avaimen voi perua milloin tahansa; sen seuraava pyyntö hylätään. Pyynnöt ilman avainta, perutulla avaimella tai avaimella, jolta puuttuu reitin käyttöalue, saavat vastaukseksi 401 tai 403 ja yhden lauseen, joka kertoo syyn.
Käyttöalueet
Osio nimeltä “Käyttöalueet”| Käyttöalue | Avaa |
|---|---|
kurv:stats:read | Neljä reittiä /api/v1/stats/*: määrät, volyymi, maksut ja lähteet, eikä missään vastauksessa ole sähköpostia tai nimeä |
kurv:admin:read | /api/v1/admin/*: hakemukset sähköposteineen, kuka hyväksyi kutsun, tekijä kunkin kokoelman takana, käytetyt paikat, päivittäinen vienti ja määrät lähteittäin |
Avaimella on yksi käyttöalue tai molemmat. Ylläpidon käyttöalue on ainoa, joka sisältää sähköposteja.
Rajapinnat
Osio nimeltä “Rajapinnat”| Pyyntö | Vastaa |
|---|---|
GET /api/v1/stats/overview?chain= | Julkaistut kokoelmat, minttaukset, yksittäiset minttaajat, volyymi, maksut, tekijät ja rekisteröitymiset, kukin viimeisiltä 24 tunnilta, viimeisiltä 7 päivältä ja koko ajalta |
GET /api/v1/stats/collections?chain=&sort=volume|mints|new&cursor= | Jokainen julkaistu kokoelma, mukana total_minted, sen volyymi kolikoittain, sen viimeisin minttaus ja sen tekijän tili, 25 sivulla |
GET /api/v1/stats/mints?chain=&since=&cursor= | Minttaukset uusimmasta alkaen, 50 sivulla, hetkestä since eteenpäin |
GET /api/v1/stats/users?chain=&since= | Rekisteröitymiset, tilit verkoittain, aktiiviset tekijät ja minttaajat, jaottelu lähdetunnisteen mukaan sekä suppilo rekisteröitymisestä julkaisuun |
GET /api/v1/admin/signups?since=&source= | Hakemukset, tilit, kutsulinkit lunastuksineen, määrät lähteittäin ja julkaisut, joilla ei ollut tunnistetta |
GET /api/v1/admin/acceptances?since=&source= | Jokainen hyväksytty kutsu uusimmasta alkaen: tili, sen profiili, sen X-käyttäjänimi, sähköposti, jos hakemus sellaisen kertoo, aika ja tunniste, jonka kanssa se tuli |
GET /api/v1/admin/creators?chain=&since= | Tekijä kunkin kokoelman takana jokaisessa verkossa tai siinä, jonka chain nimeää: tili, sen profiili, sen käyttäjänimi ja sen X-käyttäjänimi, jos se tiedetään |
GET /api/v1/admin/seats | Tähän mennessä käytetyt paikat päivä päivältä |
GET /api/v1/admin/funnel?chain=&since= | Hyväksytyt kutsut yhdessä verkossa, aikaikkunoittain ja tunnisteittain, sekä niihin liittyvä suppilo |
GET /api/v1/admin/testers | Kaikki sisään päästetyt ja kaikki, jotka raportoivat testaajan oppaassa, ja missä vaiheessa kukin heidän tehtävistään on. Heidän muistiinpanonsa jäävät pois |
GET /api/v1/admin/export?day= | Vienti, joka kirjoitetaan joka päivä klo 6:30 Guayaquilin aikaa, kyseisen päivän tai uusin, sekä luettelo päivistä, joilta vienti on olemassa: hyväksynnät, tekijät ja paikat, täydellisinä sen hetken mukaan, jolloin vienti ajettiin |
chain nimeää yhden verkon, jota käyttöönotto palvelee, base-sepolia (tai sen ketjun tunnus, 84532) tai solana-devnet; jos se jätetään pois, käytetään oletuksena olevaa EVM-ketjua. since on ISO 8601 tai unix-sekunteina. cursor on edellisen sivun pagination.next_cursor, läpinäkymätön, ja viimeisellä sivulla null.
Hyväksynnöissä, tekijöissä ja viennissä email_basis kertoo, millainen sähköposti rivillä on. email yhdessä arvon founder_tagged_link kanssa on vahvistettu: KURV-tiimi merkitsi linkin yhdelle henkilölle, sitä käytettiin kerran, ja yhdessä hakemuksessa on tunniste. email_claimed yhdessä arvon ref_tag_unverified kanssa on väite eikä koskaan henkilöllisyys: tili saapui osoitteesta, jossa oli ref-tunniste, ja yhdessä hakemuksessa on sama tunniste, mutta kuka tahansa voi kirjoittaa tällaisen osoitteen. Tunnisteet ennen 30. lokakuuta 2026 eivät anna kumpaakaan, eikä lomakkeeseen kirjoitettu käyttäjänimi anna kumpaakaan.
Jokaisessa vastauksessa on api_version, chain, environment ja read_at. Summat ovat perusyksiköitä desimaalisina merkkijonoina, yksi merkintä kolikkoa kohden kohdassa native; usd on USDC-osuus dollareina tai null, kun liikkui vain kolikko, jolla ei ole dollarilukua. Yhden kolikon rahaa ei koskaan lasketa yhteen toisen kolikon rahan kanssa.
Yksi esimerkki kustakin
Osio nimeltä “Yksi esimerkki kustakin”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 }Rajat ja tuoreus
Osio nimeltä “Rajat ja tuoreus”Kukin avain voi tehdä 120 pyyntöä minuutissa ja 30 minuutissa reiteillä /api/v1/admin/*. Sen yli vastaus on 429 ja retry-after-otsake. Jokainen vastaus on enintään 60 sekuntia vanha: palvelin lukee kerran minuutissa, ja read_at on tuon lukemisen aika. Jos haluat seurata minttauksia sitä mukaa kuin ne tapahtuvat, kutsu /api/v1/stats/mints vähintään 30 ja enintään 60 sekunnin välein niin, että since on viimeisin näkemäsi read_at; auki pidettävää virtaa ei ole.
Mitä avain ei voi tehdä
Osio nimeltä “Mitä avain ei voi tehdä”Ei mitään. Avain lukee. Se ei voi luoda kokoelmaa, valmistella julkaisua, mintata, käydä kauppaa, muuttaa profiilia eikä koskea kutsuun. Agentti, jonka kuuluu rakentaa kokoelmia, yhdistää sen sijaan MCP:n kautta henkilön luvalla, ja tuo yhteys on erillään kaikista avaimista.
Virheet käyttävät muotoa { "api_version": "1", "error": { "code": "...", "message": "..." } } tilakoodeilla 400, 401, 403, 429 tai 503. Julkiset, avaimettomat reitit kuvataan sivulla Julkiset API-rajapinnat; KURV kehittäjille listaa jokaisen aloituskohdan. Näiden lukujen maksut ovat kunkin kokoelman omia: lue Maksut ja Riskit ja vastuuvapauslauseke.
Mikään täällä ei ole sijoitusneuvontaa. Lue Riskit ja vastuuvapauslauseke ennen kuin minttaat, ostat tai myyt takaisin. Takaisin sivustolle kurv.fun. Tietosuojaseloste. Käyttöehdot. .