Quét token

Đưa token vào hàng đợi để phân tích đầy đủ và trả về trạng thái hiện tại. Lệnh gọi này có thể lặp lại an toàn: nó không bao giờ bắt đầu lượt quét thứ hai khi đang có một lượt quét chạy.

Tham số#

Yêu cầu#

curl -s -X POST "https://app.xca.fun/api/v1/scans" \
  -H "Authorization: Bearer $XCA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chain":"solana","address":"DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"}'

Phản hồi#

Phản hồi mẫu#

{
  "status": "QUEUED",
  "depth": null,
  "step": "queued",
  "progress": 0,
  "stale": false,
  "upgrading": false,
  "limitReached": false
}

Mã trạng thái#

Cách hoạt động#

• Báo cáo còn mới: trả về DONE ngay lập tức và không tính vào giới hạn quét của bạn.
• Đang quét: trả về QUEUED hoặc RUNNING kèm step và progress.
• Các trường hợp khác: đưa một lượt quét mới vào hàng đợi và dùng một lượt trong giới hạn hằng ngày của bạn.
• Đã chạm giới hạn hằng ngày nhưng có báo cáo cũ hơn: trả về trạng thái của báo cáo đó với limitReached là true.

Chờ kết quả#

Gọi GET /tokens/{chain}/{address} mỗi 3–5 giây cho đến khi trạng thái là DONE hoặc ERROR. Hầu hết các lượt quét hoàn tất trong vòng một phút.

Các bước quét#