Siirry sisältöön
Avaa sovellus

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.

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öalueAvaa
kurv:stats:readNeljä 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.

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/seatsTä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/testersKaikki 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.

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 }

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.

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. .