# RiskState

> Check how much BTC or ETH risk your trading agent may take before it trades: position size caps, leverage limits and blocked actions.

RiskState is a pre-trade risk API for crypto, and this is its Agent Skill. Before your agent opens or sizes a BTC/USD or ETH/USD position, it asks RiskState's policy engine how much exposure is allowed right now, which actions are blocked and why. It doesn't give trade signals, prices or predictions, and it doesn't place orders.

What you can do with it
- Get the current risk policy for BTC or ETH: a level from 1 (survival) to 5 (expansion), the largest position size as a share of the portfolio, and the leverage cap
- See allowed and blocked actions, such as DCA, leverage or going all in
- Check for structural blockers that should stop new entries, and context risks that should lower conviction
- See which constraint is binding (macro, on-chain, derivatives or DeFi) and its reason codes
- Pass a wallet address so DeFi borrowing health (Spark and Aave V3) feeds into the limits
- Ask for the scoring breakdown behind a policy

How it connects
- The skill calls RiskState's REST API at api.riskstate.ai with your API key (RISKSTATE_API_KEY) as a Bearer token.
- Get a key by signing up at riskstate.ai with an email address.
- It works in any agent that can make HTTPS requests.

Good to know
- It covers BTC/USD and ETH/USD only. The assessment is USD-denominated, so cross-rate risk on other pairs isn't covered.
- It applies to spot, perpetual futures and DeFi borrowing; the answer is the same, and the skill explains how to read it for each.
- The policy refreshes every 60 seconds. If the API errors or times out, the skill tells your agent to assume a block and retry after a minute.
- RiskState is free during its beta, with a per-minute rate limit.

- Type: Skill
- Made by: Riskstate
- Category: Crypto & Web3
- Formats: Skills
- Version: latest
- Website: https://riskstate.ai
- Source: https://github.com/Riskstate/risk-engine
- Page: https://pluginboard.ai/skills/riskstate

## Works with

- ChatGPT
- Claude
- Gemini
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- Replit
- OpenClaw
- OpenCode
- Hermes Agent

## Install

### ChatGPT

In ChatGPT: Download the risk-engine folder and zip it, then Plugins → Skills → Create → Upload from your computer. Business and Enterprise plans.

View the skills on GitHub: https://github.com/Riskstate/risk-engine

### Claude

In Claude (web or desktop): Download each skill’s folder and zip it, then upload them one at a time in Customize → Skills.

View the skills on GitHub: https://github.com/Riskstate/risk-engine

### Gemini

In Gemini: Download the risk-engine folder, then at gemini.google.com click Customize → Skills → Create → Upload and pick the folder (or a .zip of it).

View the skills on GitHub: https://github.com/Riskstate/risk-engine

### GitHub Copilot

Copy all 1 skills, in your terminal:

```shell
npx -y degit Riskstate/risk-engine ~/.copilot/skills/riskstate
```

View the skills on GitHub: https://github.com/Riskstate/risk-engine

### Cursor

Copy all 1 skills, in your terminal:

```shell
npx -y degit Riskstate/risk-engine ~/.cursor/skills/riskstate
```

View the skills on GitHub: https://github.com/Riskstate/risk-engine

### Claude Code

Copy all 1 skills, in your terminal:

```shell
npx -y degit Riskstate/risk-engine ~/.claude/skills/riskstate
```

View the skills on GitHub: https://github.com/Riskstate/risk-engine

### Codex

Copy all 1 skills, in your terminal:

```shell
npx -y degit Riskstate/risk-engine ~/.agents/skills/riskstate
```

View the skills on GitHub: https://github.com/Riskstate/risk-engine

### Antigravity

In Antigravity: Copy the risk-engine folder into ~/.gemini/config/skills (Antigravity app and IDE) or ~/.gemini/antigravity-cli/skills (Antigravity CLI).

View the skills on GitHub: https://github.com/Riskstate/risk-engine

### Gemini CLI

Copy all 1 skills, in your terminal:

```shell
npx -y degit Riskstate/risk-engine ~/.gemini/skills/riskstate
```

View the skills on GitHub: https://github.com/Riskstate/risk-engine

### Replit

Copy all 1 skills, in your terminal:

```shell
npx -y degit Riskstate/risk-engine .agents/skills/riskstate
```

View the skills on GitHub: https://github.com/Riskstate/risk-engine

### OpenClaw

Copy all 1 skills, in your terminal:

```shell
npx -y degit Riskstate/risk-engine ~/.openclaw/skills/riskstate
```

View the skills on GitHub: https://github.com/Riskstate/risk-engine

### OpenCode

Copy all 1 skills, in your terminal:

```shell
npx -y degit Riskstate/risk-engine ~/.config/opencode/skills/riskstate
```

View the skills on GitHub: https://github.com/Riskstate/risk-engine

### Hermes Agent

Copy all 1 skills, in your terminal:

```shell
npx -y degit Riskstate/risk-engine ~/.hermes/skills/riskstate
```

View the skills on GitHub: https://github.com/Riskstate/risk-engine

---
From Pluginboard (https://pluginboard.ai).
