xcaTài liệu
Endpoint

Ví

Hồ sơ giao dịch 30 ngày của một ví: PnL, tỷ lệ thắng, thời gian nắm giữ và nguồn tiền.

GET/api/v1/wallets/{address}

Trả về hồ sơ mà XCA đã lập cho một ví. Ví được lập hồ sơ trong quá trình quét token (với các holder lớn nhất) và theo yêu cầu trong ứng dụng; ví chưa từng được lập hồ sơ sẽ trả về 404.

Tham số#

addresspathbắt buộc
Địa chỉ ví.string

Yêu cầu#

curl -s "https://app.xca.fun/api/v1/wallets/HN7cABqLq46Es1jh92dQQisAq662SmxELLLsHHe4YWrH" \
  -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#

address
Địa chỉ ví.string
isSmart
Ví vượt ngưỡng smart money.boolean
pnl30dUsd
PnL 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
trades30d
Số giao dịch trong 30 ngày.number | null
avgHoldSec
Thời gian nắm giữ trung bình, tính bằng giây.number | null
walletAgeDays
Số ngày kể từ giao dịch đầu tiên.number | null
fundedBy
Ví đầu tiên nạp tiền cho ví này.string | null
lastProfiledAt
Thời điểm hồ sơ được lập.string

Phản hồi mẫu#

{
  "address": "HN7cABqLq46Es1jh92dQQisAq662SmxELLLsHHe4YWrH",
  "isSmart": true,
  "pnl30dUsd": 48210.7,
  "pnl30dPct": 31.4,
  "winRate": 0.64,
  "trades30d": 37,
  "avgHoldSec": 1209600,
  "walletAgeDays": 412,
  "fundedBy": "FWznbcNXWQuHTawe9RxvQ2LdCENssh12dsznf4RiouN5",
  "lastProfiledAt": "2026-10-02T08:40:11.000Z"
}

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.

Lưu ý#

  • pnl30dPct và avgHoldSec cần gói của bạn có PnL chi tiết, fundedBy cần tính năng cụm ví; nếu không, các trường này là null.
  • isSmart đánh dấu các ví vượt ngưỡng smart money: có lãi trong 30 ngày, tỷ lệ thắng cao và đủ số giao dịch.