GET /metadata

一次读取拿到关于一个代币的全部信息：名称、符号、精度、供应量、发射平台、计价 mint 与当前活跃池地址；来自其元数据 JSON 的图片、描述和社交链接；创建者与发射时间；是否毕业、毕业到哪个池；mint 账户的信息（代币程序、权限、Token-2022 扩展以及转账费）；pump.fun 代币还带有其联合曲线和创建者费率。传 mint 或 pool 二者之一（两个都传也可以；以 pool 为准）。无需密钥。

方法	GET
认证	不需要；你套餐的密钥可提高限额

示例

JavaScript

// 传 `mint` 或 `pool` 二者之一：
const params = new URLSearchParams({
  mint: "26ttsGMZeMGv6rLAaYwvdtj4671wJJjc55UGNpTVLbRL",
  // 或：pool: "9EHowJR1dph68EGpHNA8SZbpbVYqD3kx5NLcYVWrCFUy"
});

const res = await fetch(`https://sol.shrine.trade/metadata?${params}`);
const meta = await res.json();
console.log(meta);

Python

import requests

res = requests.get(
    "https://sol.shrine.trade/metadata",
    params={"mint": "26ttsGMZeMGv6rLAaYwvdtj4671wJJjc55UGNpTVLbRL"},
)
print(res.json())

响应

{
  "pool":             "9EHowJR1dph68EGpHNA8SZbpbVYqD3kx5NLcYVWrCFUy",
  "mint":             "26ttsGMZeMGv6rLAaYwvdtj4671wJJjc55UGNpTVLbRL",
  "quote":            "BMKdM4yUxX12moFqVk195k7coMbaybd4RUKCUdm7D1Sk",
  "decimals":         6,
  "program":          "PUMPSWAP",
  "total_supply":     1000000000,
  "active":           true,
  "name":             "Proof Of Quantum",
  "symbol":           "Quantum",
  "uri":              "https://metadata.j7tracker.io/m/Oq2myOORpA",
  "image":            "https://metadata.j7tracker.io/m/Oq2myOORpA-img",
  "description":      "",
  "twitter":          "https://x.com/POQuantum/status/2108240662265012379",
  "telegram":         "",
  "website":          "https://starkrdp.net/",
  "metadata_fetched": true,
  "creator":          "9xLUBtnozQ3eosq61oSuKjKw9uLGLyybwEHZsMr2b8G",
  "created_at":       1791478908,
  "graduated":        true,
  "graduated_pool":   "9EHowJR1dph68EGpHNA8SZbpbVYqD3kx5NLcYVWrCFUy",
  "graduated_at":     1791479381,
  "token_program":    "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb",
  "mint_authority":   null,
  "freeze_authority": null,
  "token_extensions": ["metadataPointer", "tokenMetadata"],
  "transfer_fee_bps": null,
  "transfer_fee_max": null,
  "pumpfun": {
    "bonding_curve":   "4FjdFepnY4DdqnUxLNkKrKEYEHhB6jSehKcXv9gBasNm",
    "creator":         "9xLUBtnozQ3eosq61oSuKjKw9uLGLyybwEHZsMr2b8G",
    "quote_mint":      "BMKdM4yUxX12moFqVk195k7coMbaybd4RUKCUdm7D1Sk",
    "creator_fee_bps": 0,
    "mayhem_mode":     false,
    "holder_reward":   false,
    "cashback":        false,
    "complete":        true,
    "virtual_token_reserves": 0,
    "virtual_sol_reserves":   0,
    "real_token_reserves":    0,
    "real_sol_reserves":      0
  }
}

字段	说明
image、description、twitter、telegram、website	来自 uri 背后的代币元数据 JSON，发射后在后台抓取一次。抓取尚未完成时 metadata_fetched 为 false（稍后再查一次即可）；空字符串表示 JSON 里没有该值。
creator、created_at	发射钱包与发射时间（unix 秒）。
graduated、graduated_pool、graduated_at	代币是否离开联合曲线、现在在哪个池交易、何时毕业。
token_program、mint_authority、freeze_authority、token_extensions	读取自 mint 账户。正常的代币两个权限都应为 null；token_extensions 列出 mint 携带的 Token-2022 扩展。
transfer_fee_bps、transfer_fee_max	税：Token-2022 转账费（基点）及其上限（原始单位），没有则为 null。
pumpfun	仅 pump.fun 代币：联合曲线、创建者费率（基点）、mayhem 模式、持有者奖励、cashback、曲线是否已完成，以及曲线存续期间的储备。其他发射平台为 null。

试一试

说明

• program 是 PUMPFUN、PUMPSWAP、METEORA、RAYDIUM、ORCA 之一——便于按 DEX 分流 UI 逻辑。
• active: false 表示该池已被取代（例如 PumpFun 联合曲线迁移到了 PumpSwap）。用 mint 查询可以找到当前活跃的那个。
• /lookup 是同一处理器的别名——参数相同，费用相同。