ZARQ API Documentation — Risk Intelligence for the Machine Economy

What is ZARQ?

ZARQ is the trust layer for autonomous financial decisions. AI agents making crypto trades, swaps, or lending decisions need independent risk assessment. ZARQ provides that: Moody's-style trust ratings (Aaa–D), distance-to-default scoring, structural collapse detection, and crash probability for 205 digital assets. Every rating is hash-chained for tamper evidence.

Track Record
100% recall on 113 structural collapses
98% precision (22 months OOS)

Coverage
205 tokens rated
50 verified crash saves

Quick Start

One HTTP call. No auth. No signup.

# Check any token's risk
curl https://zarq.ai/v1/check/bitcoin

Response

{
  "token": "bitcoin",
  "verdict": "SAFE",
  "trust_score": 74.52,
  "rating": "A2",
  "distance_to_default": 3.06,
  "structural_weakness": false,
  "crash_probability": 0.3177,
  "price_usd": 70825.0,
  "checked_at": "2026-03-08T..."
}

Verdict Values

Verdict	Meaning	Action
SAFE	No structural issues	Proceed normally
WARNING	Elevated risk	Reduce position size
CRITICAL	Structural collapse detected	Do not trade

API Endpoints

Zero-Friction Check (Recommended)

GET /v1/check/{token}

Single-call risk verdict. Use CoinGecko-style token IDs (e.g. bitcoin, ethereum, solana).

Ratings & Risk

Endpoint	Description
`GET /v1/crypto/ratings`	All token ratings
`GET /v1/crypto/rating/{token}`	Single token rating + pillars
`GET /v1/crypto/ndd/{token}`	Distance-to-default time series
`GET /v1/crypto/signals`	Active WARNING/CRITICAL signals
`GET /v1/crypto/early-warning`	Active risk alerts
`GET /v1/crypto/safety/{token}`	Lightweight pre-trade check (<100ms)
`GET /v1/crypto/distress-watch`	Tokens with DtD < 2.0
`GET /v1/crypto/compare/{t1}/{t2}`	Side-by-side comparison

Stress Test & Contagion

Endpoint	Description
`POST /v1/crypto/stresstest`	Portfolio stress test
`GET /v1/crypto/contagion/{token}`	Contagion exposure
`GET /v1/crypto/transition-matrix/{level}`	Rating transition probabilities

Crash Shield

Endpoint	Description
`GET /v1/crash-shield/saves`	All verified crash saves
`POST /v1/crash-shield/subscribe`	Webhook for crash alerts

Paper Trading

Endpoint	Description
`GET /v1/crypto/paper-trading/nav/{portfolio}`	NAV history (ALPHA, DYNAMIC, CONSERVATIVE)
`GET /v1/crypto/paper-trading/positions/{portfolio}`	Current positions
`GET /v1/crypto/paper-trading/audit`	SHA-256 audit trail

KYA — Know Your Agent

Endpoint	Description
`GET /v1/agent/kya/{name_or_id}`	Agent due diligence (trust, compliance, risk level)
`GET /kya/{name}`	KYA report page (HTML, shareable)

204K agents & tools indexed. Returns trust score, compliance score, risk level (TRUSTED/CAUTION/UNTRUSTED), and verdict.

The ZARQ Signal — Risk Feed

Endpoint	Description
`GET /v1/signal/feed`	Live risk feed — all 205 tokens sorted by severity
`GET /v1/signal/feed/history?days=30`	Daily snapshots of signal counts
`POST /v1/signal/subscribe`	Register for notifications (coming soon)
`GET /signal`	Signal dashboard page (HTML, auto-refreshing)

Bulk Data

GET /data/crypto-trust-scores.jsonl.gz

All ratings in JSONL format. CC BY 4.0 license.

Rate Limits

Tier	Calls/Day	Response
Open	0–500	Full response
Signal	500–2,000	Full response + usage headers
Degraded	2,000–5,000	Crash probability and DtD redacted
Blocked	5,000+	HTTP 402 — upgrade required

Need unlimited access? Contact [email protected] for Pro ($49/mo) or Enterprise plans.

Integrations

Add risk intelligence to your agent in 1–2 lines.

LangChain / LangGraph

from zarq_langchain import ZARQRiskCheck
tools = [ZARQRiskCheck()]
# Your agent now checks token risk before trading

pip install zarq-langchain

ElizaOS

import zarqPlugin from "@zarq/elizaos-plugin";
plugins: [zarqPlugin]
// Agent auto-checks risk on crypto questions

npm install @zarq/elizaos-plugin

Solana Agent Kit

from zarq_tool import check_token_risk
risk = check_token_risk("SOL")  # or mint address

MCP (Claude Desktop, Cursor, Windsurf)

{
  "mcpServers": {
    "zarq": { "url": "https://mcp.zarq.ai/sse" }
  }
}

Any Language (Raw HTTP)

# Python
import httpx
r = httpx.get("https://zarq.ai/v1/check/bitcoin")
data = r.json()

# JavaScript
const r = await fetch("https://zarq.ai/v1/check/bitcoin");
const data = await r.json();

# curl
curl https://zarq.ai/v1/check/bitcoin

Rating Scale

Grade	Score Range	Category
Aaa	95–100	Investment Grade
Aa1–Aa3	85–94
A1–A3	70–84
Baa1–Baa3	60–69
Ba1–Ba3	50–59	Speculative Grade
B1–B3	40–49
Caa–C	20–39
D	0–19

More Resources

Save Simulator
See the 50 biggest crashes ZARQ caught early Live Alerts
Current structural warnings Risk Scanner
Interactive portfolio risk check Paper Trading
Live trading with hash-chained audit