Genesis - Get Launches by Token | REST API

トークンミントアドレスに関連するすべてのローンチを取得します。1つのトークンに複数のローンチキャンペーンが存在する場合があるため、レスポンスはローンチの配列を返します。

Summary

トークンミントアドレスに関連するすべてのローンチを取得します。1つのトークンが異なる genesisIndex 値で複数のローンチキャンペーンを持つことができるため、ローンチの配列を返します。

トークンミント公開鍵をパスパラメータとして必要とします
launches 配列を含む TokenData オブジェクトを返します
ローンチと共にベーストークンメタデータとソーシャルリンクを含みます
メインネット（デフォルト）およびデブネットを network クエリパラメータでサポート

Quick Reference

項目	値
メソッド	`GET`
パス	`/tokens/{mint}`
認証	不要
レスポンス	`TokenData`（`launches` 配列を含む）
ページネーション	なし

エンドポイント

GET /tokens/{mint}

パラメータ

パラメータ	型	必須	説明
`mint`	`string`	はい	トークンミントの公開鍵
`network`	`string`	いいえ	クエリするネットワーク。デフォルト：`solana-mainnet`。devnet の場合は `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

1つのトークンは異なる genesisIndex 値を使用して複数のローンチを持つことができます。レスポンスは関連するすべてのローンチキャンペーンを返します。
トークンミントアドレスが見つからない場合は 404 を返します。
mechanic フィールドは割り当てメカニズム（例：launchpoolV2、presaleV2）を示します。type フィールドはローンチカテゴリ（project、memecoin、custom）を示します。