Documentation

RiskState is a deterministic engine that converts live market state into dynamic risk permissions before execution. Use it from any language over HTTP, from an AI agent via the MCP server, or as a reference for risk governance design.

Start here

API Reference → The POST /v1/risk-state endpoint. Auth, request and response schemas, action enums, risk flags, and pre-trade workflows for spot, perpetual futures, DeFi borrowing, and AI agents.

MCP Server → The @riskstate/mcp-server npm package. A single get_risk_state tool that lets any MCP-compatible agent (Claude Desktop, IDE extensions, custom MCP clients) consume RiskState directly.

Methodology → How the scoring, policy engine, and market regime classification work. Coming soon.

Research → Backtests, statistical validation, and findings. Coming soon.

Get an API key

Request API access from the home page — only an email is required. Keys are delivered by email within minutes and are free during beta.

Support

Questions, bug reports, and feedback: hello@riskstate.ai.