Genesis - Get Launch | REST API

특정 genesis 주소의 런칭 데이터를 조회합니다. 런칭 정보, 토큰 메타데이터, 웹사이트, 소셜 링크를 반환합니다.

Summary

Genesis 계정 공개 키로 단일 런치를 조회합니다. 런치 상세 정보, 베이스 토큰 메타데이터, 웹사이트, 소셜 링크를 LaunchData 객체로 반환합니다.

Genesis 계정 공개 키를 경로 파라미터로 필요
단일 LaunchData 객체 반환 (배열 아님)
토큰 메타데이터(name, symbol, image)와 소셜 링크 포함
network 쿼리 파라미터를 통해 메인넷(기본값) 및 데브넷 지원

Quick Reference

항목	값
메서드	`GET`
경로	`/launches/{genesis_pubkey}`
인증	불필요
응답	`LaunchData`
페이지네이션	없음

엔드포인트

GET /launches/{genesis_pubkey}

파라미터

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

요청 예시

curl https://api.metaplex.com/v1/launches/7nE9GvcwsqzYcPUYfm5gxzCKfmPqi68FM7gPaSfG6EQN

응답

{
  "data": {
    "launch": {
      "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 LaunchResponse {
  data: {
    launch: Launch;
    baseToken: BaseToken;
    website: string;
    socials: Socials;
  };
}

Rust

#[derive(Debug, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct LaunchData {
    pub launch: Launch,
    pub base_token: BaseToken,
    pub website: String,
    pub socials: Socials,
}

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

사용 예시

TypeScript

const response = await fetch(
  "https://api.metaplex.com/v1/launches/7nE9GvcwsqzYcPUYfm5gxzCKfmPqi68FM7gPaSfG6EQN"
);
const { data }: LaunchResponse = await response.json();
console.log(data.baseToken.name); // "My Token"

Rust

let response: LaunchResponse = reqwest::get(
    "https://api.metaplex.com/v1/launches/7nE9GvcwsqzYcPUYfm5gxzCKfmPqi68FM7gPaSfG6EQN"
)
.await?
.json()
.await?;

println!("{}", response.data.base_token.name); // "My Token"

Notes

Genesis 공개 키를 찾으려면 인덱싱 또는 getProgramAccounts가 필요합니다. 토큰 민트만 있는 경우 토큰별 런치 조회 엔드포인트를 사용하세요.
Genesis 주소를 찾을 수 없거나 유효한 런치가 없는 경우 404를 반환합니다.
mechanic 필드는 할당 메커니즘(예: launchpoolV2, presaleV2)을 나타냅니다. type 필드는 런치 카테고리(project, memecoin, custom)를 나타냅니다.