KURV data API

Sinasagot ng data API ang mga tanong ng isang agent o dashboard tungkol sa KURV: ilang koleksyon ang inilunsad, ano ang na-mint, ano ang gumalaw, saan nanggaling ang mga sign-up. Pagbabasa lang ito. Ang mga GET na ruta lang sa ilalim ng /api/v1 ang binubuksan ng isang key at wala nang iba: walang ruta rito ang lumilikha, nagbabago, pumipirma o gumagastos ng anuman.

Pagpapatunay

Bawat kahilingan ay may dalang API key bilang bearer token:

Authorization: Bearer kurv_sk_...

Ginagawa ng KURV team ang mga key, isa bawat agent, at ipinapakita nang isang beses lang kapag ginawa. Digest lang ang itinatago ng KURV, kaya ang nawalang key ay pinapalitan, hindi naibabalik. Maaaring bawiin ang key anumang oras; tatanggihan ang susunod nitong kahilingan. Ang mga kahilingang walang key, may binawing key, o may key na kulang sa saklaw ng ruta ay makakakuha ng 401 o 403 na may isang pangungusap na nagsasabi nito.

Mga saklaw

Saklaw	Binubuksan
kurv:stats:read	Ang apat na rutang /api/v1/stats/*: mga bilang, volume, bayarin at pinagmulan, na walang email at walang pangalan sa alinmang sagot
kurv:admin:read	/api/v1/admin/*: mga aplikasyon kasama ang email, kung sino ang tumanggap ng imbitasyon, ang nasa likod ng bawat koleksyon, ang mga pwestong nagamit, ang araw-araw na export at mga bilang ayon sa pinagmulan

Isang saklaw o pareho ang dala ng isang key. Ang saklaw ng admin lang ang may dalang email.

Mga endpoint

Kahilingan	Sagot
GET /api/v1/stats/overview?chain=	Mga koleksyong inilunsad, mint, natatanging minter, volume, bayarin, creator at sign-up, bawat isa para sa nakaraang 24 oras, nakaraang 7 araw at sa lahat ng panahon
GET /api/v1/stats/collections?chain=&sort=volume|mints|new&cursor=	Bawat inilunsad na koleksyon kasama ang total_minted, volume ayon sa coin, huling mint at account ng creator, 25 bawat pahina
GET /api/v1/stats/mints?chain=&since=&cursor=	Mga mint, pinakabago muna, 50 bawat pahina, mula sa since
GET /api/v1/stats/users?chain=&since=	Mga sign-up, account bawat network, aktibong creator at minter, paghahati ayon sa tag ng pinagmulan, at ang funnel mula sign-up hanggang paglulunsad
GET /api/v1/admin/signups?since=&source=	Mga aplikasyon, account, link ng imbitasyon kasama ang mga pagtubos, bilang ayon sa pinagmulan, at mga paglulunsad na walang tag
GET /api/v1/admin/acceptances?since=&source=	Bawat tinanggap na imbitasyon, pinakabago muna: ang account, ang profile nito, ang X handle nito, email kung may binanggit ang aplikasyon, ang oras at ang tag na dala nito
GET /api/v1/admin/creators?chain=&since=	Ang nasa likod ng bawat koleksyon sa bawat network, o sa network na binanggit ng chain: ang account, ang profile nito, ang handle nito at ang X handle nito kung alam
GET /api/v1/admin/seats	Ang mga pwestong nagamit na, araw-araw
GET /api/v1/admin/funnel?chain=&since=	Mga tinanggap na imbitasyon sa isang network, ayon sa panahon at tag, kasama ang funnel
GET /api/v1/admin/testers	Lahat ng nakapasok at lahat ng nag-report sa gabay, kasama ang lagay ng bawat gawain. Hindi kasama ang mga tala nila
GET /api/v1/admin/export?day=	Ang export na isinusulat araw-araw nang 6:30 AM sa Guayaquil, ang sa araw na iyon o ang pinakabago, kasama ang mga araw na mayroon: ang mga pagtanggap, ang mga gumawa at ang mga pwesto, kumpleto hanggang sa sandaling tumakbo ito

Pinapangalanan ng chain ang isang network na pinaglilingkuran ng deployment na ito, base-sepolia (o ang chain id nito, 84532) o solana-devnet; kapag inalis, ito ang default na EVM chain. Ang since ay ISO 8601 o unix seconds. Ang cursor ay ang pagination.next_cursor ng nakaraang pahina, hindi mababasa, at null sa huling pahina.

Sa mga pagtanggap, gumawa at export, sinasabi ng email_basis kung anong uri ng email ang nasa hilera. Beripikado ang email na may founder_tagged_link: tinag ng KURV team ang link para sa isang tao, isang beses itong ginamit, at isang aplikasyon ang may tag. Pahayag lang at hindi kailanman pagkakakilanlan ang email_claimed na may ref_tag_unverified: dumating ang account mula sa address na may ref tag at isang aplikasyon ang may tag na iyon, pero kahit sino ay makakapag-type ng ganoong address. Walang ibinibigay ang mga tag bago ang Oktubre 30, 2026, gayundin ang handle na itinype sa form.

Bawat sagot ay may dalang api_version, chain, environment at read_at. Ang mga halaga ay desimal na string sa pinakamaliit na yunit, isang entry bawat coin sa ilalim ng native; ang usd ay ang bahaging USDC sa dolyar, o null kapag coin lang na walang halaga sa dolyar ang gumalaw. Hindi kailanman idinadagdag ang pera sa isang coin sa pera sa ibang coin.

Tig-isang halimbawa

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 }

Mga limitasyon at pagiging sariwa

Maaaring gumawa ang bawat key ng 120 kahilingan bawat minuto, at 30 bawat minuto sa /api/v1/admin/*. Lampas doon, 429 ang sagot na may header na retry-after. Bawat sagot ay hindi hihigit sa 60 segundo ang tanda: nagbabasa ang server isang beses bawat minuto at ang read_at ay ang oras ng pagbasang iyon. Para sundan ang mga mint habang nangyayari, tawagin ang /api/v1/stats/mints tuwing 30 hanggang 60 segundo na ang since ay nakatakda sa huling read_at na nakita mo; walang stream na kailangang panatilihing bukas.

Ang hindi kayang gawin ng key

Wala. Nagbabasa ang key. Hindi ito makakagawa ng koleksyon, makakapaghanda ng paglulunsad, makakapag-mint, makakapag-trade, makakapagpalit ng profile o makakagalaw ng imbitasyon. Ang agent na dapat gumawa ng mga koleksyon ay kumokonekta sa halip sa pamamagitan ng MCP nang may pag-apruba ng tao, at hiwalay ang koneksyong iyon sa anumang key.

Gumagamit ang mga error ng { "api_version": "1", "error": { "code": "...", "message": "..." } } na may status code na 400, 401, 403, 429 o 503. Ang mga pampublikong rutang walang key ay inilalarawan sa Mga pampublikong API; nakalista sa KURV for Developers ang bawat entry point. Ang mga bayarin sa mga numerong ito ay sa bawat koleksyon mismo: basahin ang Mga bayarin at Mga panganib at disclaimer.