Pre-trade risk API for crypto — BTC/USD and ETH/USD exposure governance
_{For trading agents, open-source systems, and capital desks. Spot and perpetual futures (perps). DeFi borrowing aware.}

Website · API Reference · SKILL.md · X/Twitter

A deterministic engine that converts live market state into dynamic risk permissions — exposure limits, leverage caps, and allowed actions — before capital is deployed.

One API call returns position limits, allowed actions, and policy constraints computed from 30+ real-time signals across macro, on-chain, derivatives, and DeFi health. The assessment is USD-denominated: all scoring is based on BTC/USD and ETH/USD price action, derivatives, and macro conditions.

curl -X POST https://api.riskstate.ai/v1/risk-state \
  -H "Authorization: Bearer $RISKSTATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"asset": "BTC"}'

{
  "exposure_policy": {
    "max_size_fraction": 0.42,
    "leverage_allowed": true,
    "allowed_actions": ["DCA", "LONG_SHORT_CONFIRMED"],
    "blocked_actions": ["ALL_IN", "LEVERAGE_GT_2X"]
  },
  "policy_level": 4,
  "risk_flags": {
    "structural_blockers": [],
    "context_risks": ["HIGH_COUPLING"]
  },
  "binding_constraint": {
    "source": "MACRO",
    "reason_codes": ["MACRO_NEUTRAL", "COUPLING_NORMAL"]
  }
}

Read max_size_fraction, check structural_blockers, and act. No parsing. No interpretation.

Whether you run an AI trading agent, a systematic trading system, or a manual desk — crypto markets have regime shifts that require adaptive risk governance. Static rules fail. RiskState provides a pre-trade risk check that adapts every 60 seconds.

Sign up at riskstate.ai — email only, free during beta.

curl -X POST https://api.riskstate.ai/v1/risk-state \
  -H "Authorization: Bearer $RISKSTATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"asset": "BTC"}'

In an AI trading agent (Python):

import requests

policy = requests.post(
    "https://api.riskstate.ai/v1/risk-state",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={"asset": "BTC"}
).json()

# Hard stop: structural blockers
if policy["risk_flags"]["structural_blockers"]:
    return  # Do not trade

# Size cap — max notional exposure as fraction of portfolio
max_size = policy["exposure_policy"]["max_size_fraction"]
position_size = min(desired_size, portfolio_value * max_size)

# Action filter
if "LEVERAGE" in policy["exposure_policy"]["blocked_actions"]:
    leverage = 1.0

In a trading system (pre-trade check):

# Before placing a spot or perps order
policy = fetch_riskstate("ETH")

if policy["risk_flags"]["structural_blockers"]:
    log("BLOCKED: structural risk — skipping order")
    return

max_notional = portfolio_value * policy["exposure_policy"]["max_size_fraction"]
# Spot: max_notional is the $ amount to deploy
# Perps: max_notional is the notional exposure cap
#   e.g., at 10x leverage → margin = max_notional / 10

Manual pre-trade check (curl):

# Quick check before placing an order on Binance/Hyperliquid/Aave
curl -s -X POST https://api.riskstate.ai/v1/risk-state \
  -H "Authorization: Bearer $RISKSTATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"asset": "BTC"}' | jq '{
    policy_level, 
    max_size: .exposure_policy.max_size_fraction,
    blocked: .exposure_policy.blocked_actions,
    blockers: .risk_flags.structural_blockers
  }'

• BTC/USD — Full signal coverage (30+ indicators). Scoring based on BTC/USDT price, derivatives, and macro conditions.
• ETH/USD — Full coverage including ETH structural score, ETH/BTC ratio analysis, staking dynamics, ETH/NASDAQ correlation.

Note: The assessment is USD-denominated. If you trade non-USD pairs (e.g., BTC/EUR, ETH/BTC), additional cross-rate risk is not covered.

RiskState evaluates the same underlying market conditions regardless of where you trade. The risk assessment applies to:

The API returns the same response for all markets — the difference is how you interpret the output. See API Reference → How to Use by Context for detailed workflows.

Direct HTTP calls. Any language, any framework.

Drop SKILL.md into your agent's repo. Compatible with Claude Code, Copilot, Cursor, and Gemini via skills.sh.

npm install @riskstate/mcp-server

Or run directly with npx @riskstate/mcp-server. Docker: ghcr.io/likidodefi/riskstate-mcp.

One tool: get_risk_policy — same parameters as the REST API. Compatible with Claude Desktop, Claude Code, Cursor, and any MCP-compatible client. See MCP README for full setup.

• awesome-mcp-servers — Finance & Fintech category
• LobeHub MCP — Auto-discovered
• ClawHub.ai — Skill marketplace
• skills.sh — Vercel skills registry
• Glama.ai — AAA score

When consuming the response, agents must evaluate fields in this order:

1. risk_flags.structural_blockers — if non-empty, abort new entries
2. exposure_policy.blocked_actions — actions the agent must not take
3. exposure_policy.reduce_recommended — reduce exposure if true
4. exposure_policy.max_size_fraction — maximum position size (0.0–1.0)
5. exposure_policy.max_leverage — maximum leverage allowed

RiskState ingests 30+ real-time signals from:

• Price & Derivatives — Binance, OKX, Bybit (funding, OI, basis, L/S ratio)
• On-chain — MVRV, NUPL, exchange netflow, supply metrics (CoinGlass)
• Macro — DXY, US yields, S&P 500, Gold, Fed balance sheet (FRED, Yahoo Finance)
• DeFi — Spark Protocol, Aave V3 health factor and liquidation thresholds
• Sentiment — Fear & Greed, ETF flows, institutional treasuries
• ETH-specific — Staking ratio, burn rate, DEX volume, fees, stablecoin TVL

Free during beta. Rate limit: 60 requests/minute.

Paid tiers coming after beta. Sign up now to lock in early access.

• API Reference — Full endpoint documentation, field types, error codes
• SKILL.md — Agent discovery file with decision rules and failure modes
• Changelog — Version history and release notes
• Website — Landing page with interactive examples

• Website: riskstate.ai
• X/Twitter: @riskstate_ai
• API: POST https://api.riskstate.ai/v1/risk-state

_{Built by RiskState · © 2026 Digital Venture Asset LLC}