# OmniRisk API

> Crypto risk intelligence API. Score tokens, wallets, and market conditions via REST.

- Base URL: https://api.omnirisk.io
- Auth: x-api-key header (ri_live_* keys — generate at https://omnirisk.io/profile)
- Getting Started: https://omnirisk.io/developer/guide
- API Reference: https://omnirisk.io/developer/docs
- OpenAPI spec: https://omnirisk.io/openapi.json
- Full LLM docs: https://omnirisk.io/llms-full.txt

## Key endpoints

- GET /v1/token/analyze?chain={chain}&address={address} — Token risk score (0-100) + label (safe/caution/risky/critical)
- POST /v1/token/scan — Batch analyze up to 20 tokens
- GET /v1/token/{chain}/{address}/meta — Token metadata (name, symbol, price, liquidity)
- GET /v1/token/{chain}/{address}/explanation — AI narrative explanation of risk
- GET /v1/market/overview — Global market overview
- GET /v1/market/signals — Active market risk signals
- GET /v1/market/regime — Current market regime (bull/bear/sideways/volatile)
- POST /v1/wallet/analyze — Wallet risk analysis
- GET /v1/health — Health check (no auth)

## Chains
eth, bsc, sol, base, arb, poly, avax, ftm

## Rate limits
Free: 60 req/min | Pro: 600 req/min | Pro+: 6000 req/min

## Error shape
{"error":{"code":"RATE_LIMITED","message":"...","docs_url":"https://omnirisk.io/developer/docs#errors"}}