İçeriğe geç
Docs
Uygulamayı aç

KURV veri API’si

Veri API’si, bir ajanın ya da bir panelin KURV hakkında sorduğu soruları yanıtlar: kaç koleksiyon başlatıldı, neler mintlendi, neler hareket etti, kayıtlar nereden geldi. Yalnızca okuma yapar. Bir anahtar /api/v1 altında yalnızca GET yollarını açar, başka hiçbir şeyi açmaz: buradaki hiçbir yol bir şey oluşturmaz, değiştirmez, imzalamaz ya da harcamaz.

Kimlik doğrulama

Bölüm başlığı “Kimlik doğrulama”

Her istek bir API anahtarını bearer token olarak taşır:

Authorization: Bearer kurv_sk_...

Anahtarları KURV ekibi, ajan başına bir tane olacak şekilde oluşturur ve oluşturulduklarında bir kez gösterir. KURV yalnızca bir özet saklar; bu yüzden kaybolan bir anahtar kurtarılmaz, yenisiyle değiştirilir. Bir anahtar her an iptal edilebilir; sonraki isteği reddedilir. Anahtarsız, iptal edilmiş bir anahtarla ya da yolun kapsamına sahip olmayan bir anahtarla yapılan istekler, bunu söyleyen tek bir cümleyle 401 ya da 403 alır.

Kapsamlar

Bölüm başlığı “Kapsamlar”
KapsamAçtıkları
kurv:stats:readDört /api/v1/stats/* yolu: sayılar, hacim, ücretler ve kaynaklar; hiçbir yanıtta e-posta ya da ad yoktur
kurv:admin:read/api/v1/admin/*: e-postalarıyla başvurular, daveti kimin kabul ettiği, her koleksiyonun arkasındaki kişi, kullanılan kontenjan, günlük dışa aktarım ve kaynağa göre sayılar

Bir anahtar bir kapsam ya da ikisini birden taşır. E-posta taşıyan tek kapsam admin kapsamıdır.

Uç noktalar

Bölüm başlığı “Uç noktalar”
İstekYanıtladıkları
GET /api/v1/stats/overview?chain=Başlatılan koleksiyonlar, mintler, benzersiz mintleyenler, hacim, ücretler, yaratıcılar ve kayıtlar; her biri son 24 saat, son 7 gün ve tüm zamanlar için
GET /api/v1/stats/collections?chain=&sort=volume|mints|new&cursor=Başlatılan her koleksiyon; total_minted, kripto paraya göre hacmi, son minti ve yaratıcı hesabıyla, sayfa başına 25
GET /api/v1/stats/mints?chain=&since=&cursor=En yeniden başlayarak mintler, sayfa başına 50, since anından itibaren
GET /api/v1/stats/users?chain=&since=Kayıtlar, ağ başına hesaplar, etkin yaratıcılar ve mintleyenler, kaynak etiketine göre dağılım ve kayıttan başlatmaya giden huni
GET /api/v1/admin/signups?since=&source=Başvurular, hesaplar, kullanımlarıyla davet bağlantıları, kaynağa göre sayılar ve etiket taşımayan başlatmalar
GET /api/v1/admin/acceptances?since=&source=Kabul edilen her davet, en yenisi önce: hesap, profili, X kullanıcı adı, bir başvuru belirtiyorsa e-posta, zaman ve geldiği etiket
GET /api/v1/admin/creators?chain=&since=Her ağda ya da chain ile belirtilen ağda her koleksiyonun arkasındaki kişi: hesap, profili, kullanıcı adı ve biliniyorsa X kullanıcı adı
GET /api/v1/admin/seatsŞimdiye kadar kullanılan kontenjan, gün gün
GET /api/v1/admin/funnel?chain=&since=Bir ağdaki kabul edilen davetler, döneme ve etikete göre, ve onlarla birlikte huni
GET /api/v1/admin/testersİçeri alınan herkes ve rehberde bildirim yapan herkes, her görevin durumuyla. Notları dışarıda kalır
GET /api/v1/admin/export?day=Her gün Guayaquil saatiyle 6:30’da yazılan dışa aktarım, o günün ya da en yenisi, mevcut günlerle birlikte: kabuller, oluşturanlar ve kontenjan, çalıştığı ana kadar eksiksiz

chain, dağıtımın hizmet verdiği tek bir ağı adlandırır: base-sepolia (ya da zincir kimliği 84532) veya solana-devnet; verilmezse varsayılan EVM zinciridir. since ISO 8601 biçiminde ya da unix saniyesi olarak verilir. cursor, önceki sayfanın pagination.next_cursor değeridir; içi kapalıdır ve son sayfada null olur.

Kabullerde, oluşturanlarda ve dışa aktarımda email_basis bir satırın ne tür e-posta taşıdığını söyler. founder_tagged_link ile email doğrulanmıştır: KURV ekibi bağlantıyı tek kişi için etiketledi, bir kez kullanıldı ve etiketi bir başvuru taşıyor. ref_tag_unverified ile email_claimed bir iddiadır, asla kimlik değildir: hesap ref etiketli bir adresten geldi ve o etiketi bir başvuru taşıyor, ama böyle bir adresi herkes yazabilir. 30 Ekim 2026’dan önceki etiketler ikisini de vermez, bir forma yazılan kullanıcı adı da vermez.

Her yanıt api_version, chain, environment ve read_at taşır. Tutarlar ondalık metin (string) olarak taban birimlerdir; native altında her kripto para için bir girdi vardır. usd, USDC kısmının dolar karşılığıdır ya da yalnızca dolar karşılığı olmayan bir kripto para hareket ettiyse null olur. Bir kripto paradaki para asla başka bir kripto paradaki parayla toplanmaz.

Her birinden bir örnek

Bölüm başlığı “Her birinden bir örnek”
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 }

Sınırlar ve güncellik

Bölüm başlığı “Sınırlar ve güncellik”

Her anahtar dakikada 120 istek yapabilir; /api/v1/admin/* üzerinde dakikada 30. Bunun ötesinde yanıt, bir retry-after başlığıyla 429 olur. Her yanıt en fazla 60 saniyeliktir: sunucu dakikada bir okur ve read_at o okumanın zamanıdır. Mintleri gerçekleştikleri anda izlemek için /api/v1/stats/mints yolunu her 30 ile 60 saniyede bir, since değeri gördüğünüz son read_at olacak şekilde çağırın; açık tutulacak bir akış yoktur.

Bir anahtarın yapamadıkları

Bölüm başlığı “Bir anahtarın yapamadıkları”

Hiçbir şey. Bir anahtar okur. Koleksiyon oluşturamaz, başlatma hazırlayamaz, mintleyemez, alım satım yapamaz, profil değiştiremez ya da bir davete dokunamaz. Koleksiyon oluşturması gereken bir ajan bunun yerine kişinin onayıyla MCP üzerinden bağlanır ve bu bağlantı her anahtardan ayrıdır.

Hatalar 400, 401, 403, 429 ya da 503 durum kodlarıyla { "api_version": "1", "error": { "code": "...", "message": "..." } } biçimini kullanır. Herkese açık, anahtarsız yollar Herkese açık API’ler sayfasında anlatılır; Geliştiriciler için KURV her giriş noktasını listeler. Bu sayılardaki ücretler her koleksiyonun kendi ücretleridir: Ücretler ve Riskler ve sorumluluk reddi sayfalarını okuyun.

Buradaki hiçbir şey finansal tavsiye değildir. Mintlemeden, satın almadan veya Vault’a geri satmadan önce Riskler ve sorumluluk reddi sayfasını okuyun. kurv.fun’a geri dönün. Gizlilik politikası. Kullanım koşulları. .