公開 API

リクエスト	結果
GET /api/v1	バージョン、環境、対応チェーン、機能
GET /api/v1/collections?limit=20&offset=0&chain=84532	公開されているコレクションの設定と連携用のリンク
GET /api/v1/collections/84532/{contract_address}	登録済みのコレクション1件。キャッシュされたチェーンの数字を含みます
GET /api/v1/contracts/kurvdrop	公開されている KurvDrop の ABI。見積もりとミントを含みます

const origin = 'https://testnet.kurv.fun';
const { collections } = await fetch(`${origin}/api/v1/collections?limit=20`)
  .then(response => response.json());
const collection = collections[0];
const { collection: current } = await fetch(
  `${origin}/api/v1/collections/${collection.chain_id}/${collection.contract_address}`
).then(response => response.json());

公開 API のルートはすべて Access-Control-Allow-Origin: * を送り、読み取りだけを受け付けます。クッキーは必要ありません。一覧では、limit に 1 から 50、offset に 0 から 200 を指定できます。最後まで来ると pagination.next_offset は null になります。バージョン 1 で公開されるのは、表示対象のカタログのうち最新 200 件の範囲で、無制限の過去のインデックスではありません。詳細のルートは、直接のアドレスで到達した登録済みのコレクションにも対応しています。

金額と供給数は、整数の精度を保つため、十進数の文字列です。金額は、コレクションの支払いトークンの最小単位で表されます。表示用に整形する前に、そのトークンの decimals() と symbol() を読み取ってください。すべてのコレクションが小数点以下6桁の USDC で決済されると決めつけないでください。max_supply は、チェーンの状態が取得できるまでは、ローンチの設定から取られます。total_minted は、読み取り値が得られるまでは、でっちあげたゼロではなく null になります。

詳細の読み取りでは、KURV が共有している15秒間のチェーンのキャッシュを再利用します。reading.read_at は読み取りが成功した時刻を記録します。reading.status: "stale_or_unavailable" は、直近の試行が失敗し、数字はすべて最後に成功した読み取りのものであることを意味します。このレスポンスに含まれる見積もりは参考情報で、既定の有効なフェーズでの作品1点 についてのものです。そのウォレットがミントできることを証明するものではありません。署名する直前に、新しい quoteMint を取得してください。

リビール前のトークンのメディアとメタデータのルートは伏せられます。別に公開されたティザーは表示されたままにできます。非公開の許可リスト、公開ファイルの一覧、シード、アカウントの認証情報、インフラの生のエラーは、バージョン 1 には一切含まれません。エラーは { "api_version": "1", "error": { "code": "...", "message": "..." } } の形で、ステータスコード 400、404、503 とともに返されます。

Base Sepolia（チェーン ID 84532）には https://testnet.kurv.fun を使います。使える入り口は開発者向け KURVに一覧があります。価格と手数料はコレクションによって異なります。手数料とリスクと免責事項をお読みください。