xcaTài liệu
Endpoint

Holder

Danh sách holder đã phân loại của một token đã quét, kèm PnL, thời điểm mua vào và nguồn tiền, theo từng trang.

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

Trả về các holder đã được phân tích của một token, sắp xếp theo thứ hạng, kèm loại mà XCA đã gán cho từng ví. Token phải được quét trước; nếu không, bạn sẽ nhận 404.

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
pagequery
Số trang, bắt đầu từ 1.integer ≥ 1mặc định: 1
pageSizequery
Số holder mỗi trang.10 | 25 | 50 | 100mặc định: 100
classquery
Chỉ trả về holder thuộc loại này.ALL | HolderClassmặc định: ALL

Yêu cầu#

curl -s "https://app.xca.fun/api/v1/tokens/solana/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263/holders?class=SMART_MONEY&pageSize=25" \
  -H "Authorization: Bearer $XCA_API_KEY"
Thử ngay
Dán khóa API của bạn để gửi yêu cầu thật.

Phản hồi#

rows
Các holder trong trang này.HolderRow[]
rank
Thứ hạng theo số dư, 1 là lớn nhất.number
address
Địa chỉ ví.string | null
sharePct
Tỷ lệ nguồn cung đang nắm giữ.number
valueUsd
Giá trị lượng token nắm giữ, tính bằng USD.number | null
class
Loại mà XCA đã gán cho ví.HolderClass | "HIDDEN"
flags
Các đặc điểm bổ sung của ví.string[]
entryAt
Thời điểm mua lần đầu.string | null
entryBlock
Số block từ lúc ra mắt đến lần mua đầu tiên (sniper có số nhỏ).number | null
pnl30dUsd
PnL đã chốt và chưa chốt trong 30 ngày, tính bằng USD.number | null
pnl30dPct
PnL trong 30 ngày, tính theo phần trăm.number | null
winRate
Tỷ lệ giao dịch có lãi, từ 0 đến 1.number | null
avgHoldSec
Thời gian nắm giữ trung bình, tính bằng giây.number | null
trades30d
Số giao dịch trong 30 ngày.number | null
fundedBy
Ví đầu tiên nạp tiền cho ví này.string | null
clusterId
Cụm mà ví này thuộc về.string | null
profiled
Đã có hồ sơ ví đầy đủ.boolean
total
Số holder hiển thị khớp với bộ lọc.number
lockedCount
Số holder bị ẩn do giới hạn của gói.number
page
Trang hiện tại.number
pageSize
Số holder mỗi trang.number
visibleLimit
Số top holder mà gói của bạn hiển thị; -1 nghĩa là tất cả.number

Phản hồi mẫu#

{
  "rows": [
    {
      "rank": 4,
      "address": "5Hr7wZg7oBpVhH5nngRqzr5W7ZFUfCsfEhbziZJak7fr",
      "sharePct": 1.92,
      "valueUsd": 3641200,
      "class": "SMART_MONEY",
      "flags": [
        "smart"
      ],
      "entryAt": "2023-01-04T18:22:10.000Z",
      "entryBlock": null,
      "pnl30dUsd": 48210.7,
      "pnl30dPct": 31.4,
      "winRate": 0.64,
      "avgHoldSec": 1209600,
      "trades30d": 37,
      "fundedBy": "FWznbcNXWQuHTawe9RxvQ2LdCENssh12dsznf4RiouN5",
      "clusterId": null,
      "profiled": true
    }
  ],
  "total": 7,
  "lockedCount": 0,
  "page": 1,
  "pageSize": 25,
  "visibleLimit": -1
}

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.
404notFound — Token chưa được quét hoặc ví chưa được lập hồ sơ.
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.

Các loại holder#

SMART_MONEYTrader có lãi trong 30 ngày với tỷ lệ thắng cao.
REGULARKhông có gì đáng chú ý.
DEVNgười tạo token.
DEV_BUNDLEMua cùng lúc với người tạo hoặc được người tạo nạp tiền.
SNIPERMua trong những block đầu tiên sau khi ra mắt.
FRESHVí mới được tạo rất gần đây.
POOLPool thanh khoản, vault hoặc bonding curve.
CEXVí của sàn giao dịch tập trung.
BURNĐịa chỉ burn.

Lưu ý#

  • Gói của bạn giới hạn số top holder được hiển thị; total chỉ đếm những holder hiển thị, còn lockedCount cho biết còn bao nhiêu holder nữa.
  • Lọc theo SNIPER, DEV_BUNDLE, SMART_MONEY hoặc FRESH cần gói của bạn có tính năng tương ứng, nếu không bạn sẽ nhận 402.
  • Loại mà gói của bạn không được xem sẽ được trả về là HIDDEN.
  • Các trường PnL phụ thuộc vào cấp độ PnL của gói: mức cơ bản có pnl30dUsd và winRate, mức chi tiết có thêm pnl30dPct, avgHoldSec và trades30d.