FOXSCAN

Integration signal API preview

Risk Signal Lab · BNB Chain

Put holder-risk evidence in the path of every trade.

Send a token address. Receive the launch context, grouped holder evidence, and a deterministic verdict your product can explain.

View integration example Request API access on X (opens in a new tab)

curl --request POST https://api.foxscanner.io/v1/scans \
  --header "Authorization: Bearer $FOXSCANNER_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"chain":"bnb","address":"0x7fA9385bE102ac3EAc297483Dd6233D62b3e1496"}'

const response = await fetch("https://api.foxscanner.io/v1/scans", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.FOXSCANNER_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    chain: "bnb",
    address: "0x7fA9385bE102ac3EAc297483Dd6233D62b3e1496",
  }),
});

response = requests.post(
    "https://api.foxscanner.io/v1/scans",
    headers={"Authorization": f"Bearer {FOXSCANNER_API_KEY}"},
    json={
        "chain": "bnb",
        "address": "0x7fA9385bE102ac3EAc297483Dd6233D62b3e1496",
    },
    timeout=10,
)

{
  "scan_id": "scan_demo_01",
  "status": "complete",
  "verdict": { "band": "high", "score": 82 },
  "signals": {
    "linked_wallet_share": 0.41,
    "fresh_wallet_share": 0.18,
    "sniper_share": 0.09
  },
  "data_mode": "representative_preview"
}

{
  "error": {
    "code": "invalid_address",
    "message": "address must be a 20-byte EVM address",
    "field": "address"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "request quota exceeded",
    "retry_after_seconds": 30
  }
}

{
  "scan_id": "scan_demo_01",
  "status": "pending",
  "poll_after_seconds": 3
}

Schema and values are representative preview content, not a live API response or availability guarantee.

Signal pipeline

Evidence enters once. Every verdict keeps its trail.

The diagram is a deterministic simulation of the fields that contribute to a representative response.

Four-stage pipeline from a token address through launch context and holder graph to a high-risk verdict. — Simulation No live chain activity is shown.

01
Address acceptedchain · address
02
Launch locatedlaunchpad · block · pair
03
Holders groupedlinked · fresh · snipers
04
Verdict resolvedband · score · evidence

SIMULATION00:00 address accepted00:01 launch located00:02 holders grouped00:03 verdict ready

Integration map

Use the smallest contract that fits the decision.

Suggested integration patterns, not customer claims or measured performance.

01 / Pre-trade

Trading bot

Gate an order on a completed holder-risk verdict.

Endpoint: POST /v1/scans
Cadence: Before trade

02 / Detail view

Token terminal

Render a verdict with the evidence behind the score.

Endpoint: GET /v1/scans/:id
Cadence: On view

03 / Safety layer

Wallet warning

Surface a clear warning before a user confirms a swap.

Endpoint: GET /v1/tokens/:address/risk
Cadence: Before signature

04 / Monitoring

Research feed

Collect changed verdicts for human review and enrichment.

Endpoint: GET /v1/verdicts
Cadence: Scheduled pull

Endpoint contracts

Inspect the route before you wire it in.

Preview contracts may change before access is generally available.

POST/v1/scansCreate or reuse a scan

Accepts a supported chain and token address. Returns a completed result or a pending scan identifier.

Required: chain, address
Responses: 200, 202, 400, 429

GET/v1/scans/:scan_idRead one scan result

Returns scan status, holder-risk verdict, and supporting evidence fields for a known scan.

Required: scan_id
Responses: 200, 404, 429

GET/v1/tokens/:address/riskRead latest token verdict

Returns the latest available holder-risk verdict for a supported token address.

Query: chain=bnb
Responses: 200, 404, 429

GET/v1/verdictsRead a verdict feed

Returns a cursor-paginated preview feed of recently changed holder-risk verdicts.

Optional: cursor, band, limit
Responses: 200, 400, 429

Preview pricing

Model the integration. Treat every limit as temporary.

Prices, quotas, features, and availability below are planning examples only. They are not an active offer.

Preview plan

Plan preview requires JavaScript. Request access for current availability and terms.

Contract boundary

Holder risk is one signal, not a safety guarantee.

Covered by this preview

Holder concentration
Linked wallet groups
Fresh-wallet participation
Observed sniper participation

Not covered by this score

Owner privileges
Token taxes
Honeypot behavior
Mint or upgrade authority