Genesis - Get Launches by Token | REST API

토큰 민트 주소와 관련된 모든 런칭을 조회합니다. 하나의 토큰에 여러 런칭 캠페인이 있을 수 있으므로 응답은 런칭 배열을 반환합니다.

Summary

토큰 민트 주소와 관련된 모든 런치를 조회합니다. 하나의 토큰이 다른 genesisIndex 값으로 여러 런치 캠페인을 가질 수 있으므로 런치 배열을 반환합니다.

토큰 민트 공개 키를 경로 파라미터로 필요
launches 배열을 포함하는 TokenData 객체 반환
런치와 함께 베이스 토큰 메타데이터 및 소셜 링크 포함
network 쿼리 파라미터를 통해 메인넷(기본값) 및 데브넷 지원

Quick Reference

항목	값
메서드	`GET`
경로	`/tokens/{mint}`
인증	불필요
응답	`TokenData`（`launches` 배열 포함）
페이지네이션	없음

엔드포인트

GET /tokens/{mint}

파라미터

파라미터	타입	필수	설명
`mint`	`string`	Yes	토큰 민트 공개 키
`network`	`string`	No	조회할 네트워크. 기본값: `solana-mainnet`. 데브넷의 경우 `solana-devnet`을 사용하세요.

요청 예시

curl https://api.metaplex.com/v1/tokens/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

응답

{
  "data": {
    "launches": [
      {
        "launchPage": "https://example.com/launch/mytoken",
        "mechanic": "launchpoolV2",
        "genesisAddress": "7nE9GvcwsqzYcPUYfm5gxzCKfmPqi68FM7gPaSfG6EQN",
        "spotlight": false,
        "startTime": "2026-01-15T14:00:00.000Z",
        "endTime": "2026-01-15T18:00:00.000Z",
        "status": "graduated",
        "heroUrl": "launches/abc123/hero.webp",
        "graduatedAt": "2026-01-15T18:05:00.000Z",
        "lastActivityAt": "2026-01-15T17:45:00.000Z",
        "type": "project"
      }
    ],
    "baseToken": {
      "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "name": "My Token",
      "symbol": "MTK",
      "image": "https://example.com/token-image.png",
      "description": "A community-driven token for the example ecosystem."
    },
    "website": "https://example.com",
    "socials": {
      "x": "https://x.com/mytoken",
      "telegram": "https://t.me/mytoken",
      "discord": "https://discord.gg/mytoken"
    }
  }
}

응답 타입

Launch, BaseToken, Socials 정의는 공유 타입을 참조하세요.

TypeScript

interface TokenResponse {
  data: {
    launches: Launch[];
    baseToken: BaseToken;
    website: string;
    socials: Socials;
  };
}

Rust

#[derive(Debug, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct TokenData {
    pub launches: Vec<Launch>,
    pub base_token: BaseToken,
    pub website: String,
    pub socials: Socials,
}

#[derive(Debug, Serialize, Deserialize)]
pub struct TokenResponse {
    pub data: TokenData,
}

사용 예시

TypeScript

const response = await fetch(
  "https://api.metaplex.com/v1/tokens/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
);
const { data }: TokenResponse = await response.json();
console.log(data.launches.length); // Number of launch campaigns
console.log(data.baseToken.symbol); // "MTK"

Rust

let response: TokenResponse = reqwest::get(
    "https://api.metaplex.com/v1/tokens/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
)
.await?
.json()
.await?;

println!("{} launches found", response.data.launches.len());

Notes

하나의 토큰은 다른 genesisIndex 값을 사용하여 여러 런치를 가질 수 있습니다. 응답은 관련된 모든 런치 캠페인을 반환합니다.
토큰 민트 주소를 찾을 수 없는 경우 404를 반환합니다.
mechanic 필드는 할당 메커니즘(예: launchpoolV2, presaleV2)을 나타냅니다. type 필드는 런치 카테고리(project, memecoin, custom)를 나타냅니다.