For LLMs & agents

CSDS is built to be called by autonomous agents. Machine-readable manifests, a typed API, and Markdown-friendly docs make integration straightforward.

Machine-readable entry points

Copy any page as Markdown

Every docs page has a Copy as Markdown action (top-right of the content) that yields clean Markdown for prompting — headings, code, and tables preserved. Token pages are also available as .md (e.g. /tokens/<chain>/<address>.md).

Recommended agent flow

1. Resolve the contract address and chain from the user's request.
2. Call /api/v1/standard-report for a full verdict; escalate to deep dive when the user needs history, code analysis, or website intelligence.
3. Branch on risk_level / recommendation; surface top_flags verbatim.
4. Respect confidence — if low, tell the user data was limited rather than implying safety.
5. Handle 402 (payment), 429 (back off), and 400/404 (bad input) per the error reference.

Example

import httpx

def is_risky(address: str, chain: str) -> dict:
    r = httpx.post(
        "https://csds.blockchainrangers.com/api/v1/standard-report",
        json={"project_address": address, "chain": chain},
    )
    r.raise_for_status()
    d = r.json()
    return {"risky": d["risk_score"] >= 51, "level": d["risk_level"], "flags": d["top_flags"]}

Next