Endpoint

Báo cáo token

Dữ liệu thị trường, bảo mật, Holder Score, chỉ số holder, cụm ví, lịch sử dev và hoạt động giao dịch của một token.

GET/api/v1/tokens/{chain}/{address}

Trả về báo cáo mới nhất mà XCA có cho một token. Việc đọc báo cáo không bao giờ kích hoạt quét: nếu trạng thái là NONE, token chưa được quét, vì vậy hãy gọi POST /scans trước.

Tham số#

chainpathbắt buộc

ID của chain. Hiện chỉ hỗ trợ solana."solana"

addresspathbắt buộc

Địa chỉ mint của token.string

Yêu cầu#

curl -s "https://app.xca.fun/api/v1/tokens/solana/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263" \
  -H "Authorization: Bearer $XCA_API_KEY"

Thử ngay

Khóa APILấy khóa APIChỉ được lưu trong tab trình duyệt này và chỉ gửi tới API của XCA.

chainpathaddresspath

Dán khóa API của bạn để gửi yêu cầu thật.

Phản hồi#

chain

ID của chain.string

address

Địa chỉ mint của token.string

status

Trạng thái báo cáo. NONE nghĩa là token chưa từng được quét."NONE" | "QUEUED" | "RUNNING" | "DONE" | "ERROR"

depth

LIGHT khi cặp mới được quét tự động, FULL khi phân tích đầy đủ."LIGHT" | "FULL" | null

upgrading

Báo cáo LIGHT đang được nâng cấp lên FULL.boolean

step

Bước quét hiện tại trong lúc quá trình quét đang chạy.string | null

progress

Tiến độ quét từ 0 đến 100.number

errorMessage

Lý do lượt quét gần nhất thất bại, khi status là ERROR.string | null

symbol

Ticker của token.string | null

name

Tên token.string | null

imageUrl

URL logo của token.string | null

market

Cặp giao dịch chính theo DexScreener.object | null

pairAddress

Địa chỉ của cặp có thanh khoản cao nhất.string | null

dexId

DEX của cặp đó.string | null

url

Trang DexScreener của cặp.string | null

name

Tên token theo dữ liệu của cặp.string | null

symbol

Ticker của token theo dữ liệu của cặp.string | null

quoteSymbol

Tài sản định giá của cặp, ví dụ SOL.string | null

imageUrl

Logo token lấy từ DexScreener.string | null

priceUsd

Giá tính bằng USD.number | null

liquidityUsd

Thanh khoản của tất cả pool, tính bằng USD.number | null

fdvUsd

Định giá pha loãng hoàn toàn (FDV), tính bằng USD.number | null

marketCapUsd

Vốn hóa thị trường, tính bằng USD.number | null

volume24hUsd

Khối lượng giao dịch trong 24 giờ, tính bằng USD.number | null

txns24h

Số giao dịch mua và bán trong 24 giờ.{ buys, sells } | null

change

Biến động giá theo phần trăm trong 5 phút, 1 giờ, 6 giờ và 24 giờ.{ m5, h1, h6, h24 }

pairCreatedAt

Thời điểm cặp được tạo.string | null

poolAddresses

Địa chỉ của tất cả pool đã biết của token.string[]

websites

Website của dự án.{ url, label }[]

socials

Liên kết mạng xã hội của dự án.{ type, url }[]

fetchedAt

Thời điểm lấy dữ liệu thị trường.string

security

Thông tin on-chain về mint.object | null

mintAuthority

Ai có thể mint thêm token mới; null nếu quyền này đã bị thu hồi.string | null

freezeAuthority

Ai có thể đóng băng tài khoản của holder; null nếu quyền này đã bị thu hồi.string | null

program

Token program của mint."spl-token" | "spl-token-2022" | "unknown"

supply

Tổng cung, tính theo số token nguyên.number

decimals

Số chữ số thập phân của token.number

creator

Ví đã tạo token, nếu xác định được.string | null

createdAt

Thời điểm mint được tạo.string | null

computedAt

Thời điểm báo cáo được tính toán.string | null

stale

Báo cáo đã quá thời gian lưu cache.boolean

holderScore

Holder Score từ 0 (nguy hiểm) đến 100 (sạch).number | null

riskLevel

Mức rủi ro suy ra từ điểm số."low" | "medium" | "high" | null

metrics

Các chỉ số phân bổ; các key được trả về tùy thuộc vào gói của bạn.object | null

limited

Dữ liệu holder chỉ có một phần (do giới hạn của nhà cung cấp).boolean

holdersTotal

Tổng số holder.number

holdersAnalyzed

Số holder được đưa vào phân tích.number

profiled

Số holder có hồ sơ ví đầy đủ.number

top10Pct

Tỷ lệ do 10 holder thực lớn nhất nắm giữ (không tính pool, địa chỉ burn và sàn giao dịch).number

topHolderPct

Tỷ lệ do holder thực lớn nhất nắm giữ.number

floatPct

Nguồn cung lưu hành: tỷ lệ nằm ngoài pool và địa chỉ burn.number

devPct

Tỷ lệ do người tạo token nắm giữ.number

devBundlePct

Tỷ lệ do các ví trong bundle của người tạo nắm giữ.number

sniperCount

Số ví sniper.number

sniperPct

Tỷ lệ do sniper nắm giữ.number

freshCount

Số ví mới.number

freshPct

Tỷ lệ do ví mới nắm giữ.number

clusterPct

Tỷ lệ do các cụm ví có chung ví nạp tiền nắm giữ.number

smartCount

Số holder smart money.number

smartPct

Tỷ lệ do smart money nắm giữ.number

poolPct

Tỷ lệ nằm trong các pool thanh khoản.number

burnPct

Tỷ lệ đã được gửi tới địa chỉ burn.number

avgPnlUsd

PnL trung bình 30 ngày của các holder đã được lập hồ sơ, tính bằng USD.number | null

launchAt

Thời điểm bắt đầu giao dịch.string | null

launchSlot

Slot Solana của giao dịch đầu tiên.number | null

scoreVersion

Phiên bản mô hình Holder Score đã dùng để chấm điểm báo cáo.number

breakdown

Từng yếu tố của Holder Score kèm số điểm và giá trị đo được.{ key, points, value, total?, cap? }[]

mainReason

Yếu tố làm mất nhiều điểm nhất.{ key, points, value, total?, cap? } | null

clusters

Các nhóm holder được nạp tiền từ cùng một ví.object[] | null

id

ID của cụm, được tham chiếu bởi clusterId của holder.string

funder

Ví đã nạp tiền cho các thành viên.string

funderLabel

Nhãn đã biết của ví nạp tiền, ví dụ một sàn giao dịch.string | null

members

Các ví thành viên.string[]

sharePct

Tỷ lệ do cụm nắm giữ.number

clustersCount

Số cụm ví, kể cả khi danh sách cụm bị khóa.number

devHistory

Các lần ra mắt trước đây của người tạo.object | null

creator

Ví của người tạo.string | null

launches

Số token người tạo đã ra mắt.number

rugs

Số lần ra mắt đã mất thanh khoản.number

avgLifespanSec

Tuổi thọ trung bình của các token do người tạo ra mắt, nếu xác định được.number | null

tokens

Danh sách các lần ra mắt, mới nhất xếp trước.{ address, symbol, name, createdAt, liquidityUsd, fdvUsd, rugged }[]

approximate

Được suy ra từ những lần mua sớm nhất của người tạo, nên hãy coi đây là số liệu ước tính.true

devTeaser

Số lần ra mắt và số lần rug, kể cả khi lịch sử dev bị khóa.{ launches, rugs } | null

activity

Hoạt động giao dịch gần đây trên cặp chính.object | null

recent

Các swap mới nhất; time là Unix timestamp tính bằng mili giây.{ signature, time, wallet, side, amount, valueUsd }[]

topTraders

Những trader có lãi nhiều nhất với token này.{ wallet, boughtUsd, soldUsd, pnlUsd, trades }[]

locked

Các tính năng mà gói của bạn không bao gồm; các trường của chúng là null hoặc bị lược bỏ.string[]

Phản hồi mẫu#

{
  "chain": "solana",
  "address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
  "status": "DONE",
  "depth": "FULL",
  "upgrading": false,
  "step": "done",
  "progress": 100,
  "errorMessage": null,
  "symbol": "Bonk",
  "name": "Bonk",
  "imageUrl": "https://arweave.net/hQiPZOsRZXGXBJd_82PhVdlM_hACsT_q6wqwf5cSY7I",
  "market": {
    "pairAddress": "6oFWm7KPLfxnwMb3z5xwBoXNSPP3JJyirAPqPSiVcnsp",
    "dexId": "raydium",
    "url": "https://dexscreener.com/solana/6ofwm7kplfxnwmb3z5xwboxnspp3jjyirapqpsivcnsp",
    "name": "Bonk",
    "symbol": "Bonk",
    "quoteSymbol": "SOL",
    "imageUrl": "https://arweave.net/hQiPZOsRZXGXBJd_82PhVdlM_hACsT_q6wqwf5cSY7I",
    "priceUsd": 0.00002134,
    "liquidityUsd": 2864210.4,
    "fdvUsd": 1897000000,
    "marketCapUsd": 1652000000,
    "volume24hUsd": 18450000,
    "txns24h": {
      "buys": 18210,
      "sells": 16930
    },
    "change": {
      "m5": 0.4,
      "h1": -1.2,
      "h6": 3.8,
      "h24": 5.1
    },
    "pairCreatedAt": "2022-12-25T11:04:12.000Z",
    "poolAddresses": [
      "6oFWm7KPLfxnwMb3z5xwBoXNSPP3JJyirAPqPSiVcnsp"
    ],
    "websites": [
      {
        "url": "https://bonkcoin.com",
        "label": "Website"
      }
    ],
    "socials": [
      {
        "type": "twitter",
        "url": "https://x.com/bonk_inu"
      }
    ],
    "fetchedAt": "2026-10-02T09:12:40.000Z"
  },
  "security": {
    "mintAuthority": null,
    "freezeAuthority": null,
    "program": "spl-token",
    "supply": 88870000000000,
    "decimals": 5,
    "creator": "9AhKqLR67hwapvG8SA2JFXaCshXc9nALJjpKaHZrsbkw",
    "createdAt": "2022-12-25T10:52:01.000Z"
  },
  "computedAt": "2026-10-02T09:12:44.000Z",
  "stale": false,
  "holderScore": 84,
  "riskLevel": "low",
  "metrics": {
    "limited": false,
    "holdersTotal": 912345,
    "holdersAnalyzed": 4000,
    "profiled": 100,
    "top10Pct": 64.2,
    "topHolderPct": 31.7,
    "floatPct": 96.6,
    "devPct": 0,
    "devBundlePct": 0.3,
    "sniperCount": 2,
    "sniperPct": 6.6,
    "freshCount": 41,
    "freshPct": 17.6,
    "clusterPct": 8.8,
    "smartCount": 7,
    "smartPct": 2.1,
    "poolPct": 3.4,
    "burnPct": 0,
    "avgPnlUsd": 1840.5,
    "launchAt": "2022-12-25T11:04:12.000Z",
    "launchSlot": 168410720,
    "scoreVersion": 2,
    "breakdown": [
      {
        "key": "top10",
        "points": -17.2,
        "value": 66.5
      },
      {
        "key": "topHolder",
        "points": -5.9,
        "value": 32.8
      },
      {
        "key": "devBundle",
        "points": 0,
        "value": 0.3
      },
      {
        "key": "snipers",
        "points": -0.6,
        "value": 6.8
      },
      {
        "key": "clusters",
        "points": -1.8,
        "value": 9.1
      },
      {
        "key": "fresh",
        "points": -0.6,
        "value": 18.2
      },
      {
        "key": "holders",
        "points": 0,
        "value": 912345
      },
      {
        "key": "authorities",
        "points": 0,
        "value": 0
      },
      {
        "key": "devRugs",
        "points": 0,
        "value": 0,
        "total": 1
      },
      {
        "key": "liquidity",
        "points": 0,
        "value": 2864210.4
      },
      {
        "key": "smartMoneyBonus",
        "points": 10,
        "value": 7
      }
    ],
    "mainReason": {
      "key": "top10",
      "points": -17.2,
      "value": 66.5
    }
  },
  "clusters": [
    {
      "id": "c1",
      "funder": "5tzFkiKscXHK5ZXCGbXZxdw7gTjjD1mBwuoFbhUvuAi9",
      "funderLabel": null,
      "members": [
        "3Kv1…",
        "8Zq4…",
        "Fh2T…"
      ],
      "sharePct": 1.8
    }
  ],
  "clustersCount": 3,
  "devHistory": {
    "creator": "9AhKqLR67hwapvG8SA2JFXaCshXc9nALJjpKaHZrsbkw",
    "launches": 1,
    "rugs": 0,
    "avgLifespanSec": null,
    "tokens": [],
    "approximate": true
  },
  "devTeaser": {
    "launches": 1,
    "rugs": 0
  },
  "activity": {
    "recent": [
      {
        "signature": "4Vt2…",
        "time": 1790932360000,
        "wallet": "7xKX…",
        "side": "buy",
        "amount": 152000000,
        "valueUsd": 3244.1
      }
    ],
    "topTraders": [
      {
        "wallet": "2bQm…",
        "boughtUsd": 41200,
        "soldUsd": 78900,
        "pnlUsd": 37700,
        "trades": 18
      }
    ]
  },
  "locked": []
}

Mã trạng thái#

200Thành công

400validation — Một tham số hoặc body không hợp lệ; xem error.issues.

401unauthorized — Khóa API bị thiếu, sai định dạng hoặc đã bị thu hồi.

402planRequired — Gói của bạn không bao gồm quyền truy cập API hoặc tính năng này.

429rateLimited — Quá nhiều yêu cầu mỗi phút, hoặc đã dùng hết hạn mức hằng tháng.

Trạng thái báo cáo#

`NONE`	Chưa từng được quét. Hãy bắt đầu quét bằng `POST /scans.`
`QUEUED`	Đang chờ worker xử lý.
`RUNNING`	Đang được phân tích; xem step và progress.
`DONE`	Đã xong; báo cáo đã hoàn chỉnh.
`ERROR`	Lượt quét gần nhất thất bại; xem `errorMessage` và thử lại.

Lưu ý#

Các trường thuộc những tính năng mà gói của bạn không bao gồm sẽ là null hoặc bị lược bỏ, và key của các tính năng đó được liệt kê trong locked.
stale là true khi báo cáo đã quá thời gian lưu cache; một lệnh gọi POST /scans mới sẽ làm mới báo cáo.
Báo cáo LIGHT đến từ việc tự động quét cặp mới và không có PnL của ví cho đến khi có người mở; trong lúc báo cáo đang được nâng cấp, upgrading là true.
Tỷ lệ nắm giữ là phần trăm trên tổng cung, bao gồm cả token nằm trong các pool.