공개 API

요청	결과
GET /api/v1	버전, 환경, 지원하는 체인과 기능
GET /api/v1/collections?limit=20&offset=0&chain=84532	공개 컬렉션 설정과 연동 링크
GET /api/v1/collections/84532/{contract_address}	등록된 컬렉션 하나. 캐시된 체인 수치 포함
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: *를 보내고 읽기만 받아요. 쿠키는 필요 없어요. 목록은 1에서 50 사이의 limit과 0에서 200 사이의 offset을 받고, 끝에 도달하면 pagination.next_offset이 null이에요. 버전 1은 무한한 과거 인덱스가 아니라, 공개된 카탈로그 레코드 중 가장 최근 200개의 범위를 제공해요. 상세 경로는 직접 주소로 접근한 등록 컬렉션도 지원해요.

금액과 공급 수량은 정수 정밀도를 지키기 위해 십진수 문자열이에요. 금액은 컬렉션 결제 토큰의 최소 단위를 써요. 형식을 맞추기 전에 그 토큰의 decimals()와 symbol()을 읽으세요. 모든 컬렉션이 소수점 여섯 자리인 USDC로 정산된다고 가정하지 마세요. max_supply는 체인 상태를 읽을 수 있을 때까지 런칭 설정에서 가져와요. total_minted는 읽은 값이 생길 때까지 지어낸 0이 아니라 null이에요.

상세 읽기는 KURV가 공유하는 15초 체인 캐시를 재사용해요. reading.read_at은 읽기가 성공한 시각을 기록해요. reading.status: "stale_or_unavailable"은 가장 최근 시도가 실패했고, 수치가 있다면 마지막으로 성공한 읽기의 값이라는 뜻이에요. 이 응답의 시세는 참고용으로, 기본 활성 단계의 작품 하나에 대한 것이며, 그 지갑이 민팅할 수 있다는 증거가 아니에요. 서명하기 직전에 새 quoteMint를 받으세요.

리빌되지 않은 토큰의 미디어와 메타데이터 루트는 공개되지 않아요. 따로 공개된 티저는 계속 보일 수 있어요. 비공개 허용 목록, 공개 파일 목록, 시드, 계정 자격 증명, 인프라의 원본 오류는 버전 1에 절대 포함되지 않아요. 오류는 { "api_version": "1", "error": { "code": "...", "message": "..." } } 형식이고, 상태 코드는 400, 404, 503이에요.

Base Sepolia에는 https://testnet.kurv.fun을 쓰세요. 체인 ID는 84532예요. 쓸 수 있는 진입점은 개발자를 위한 KURV에 나와 있어요. 가격과 수수료는 컬렉션에 따라 달라요. 수수료와 리스크 및 면책 조항을 읽어 주세요.