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`	是	genesis 账户公钥
`network`	`string`	否	查询的网络。默认：`solana-mainnet`。使用 `solana-devnet` 查询 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）。