---
title: "Free Analyze Trade"
method: POST
path: "/api/v1/analyze/free"
---

# Free Analyze Trade

`POST /api/v1/analyze/free`

## Request

- Base URL: `https://api.collarguardrail.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.collarguardrail.com/api/v1/analyze/free`
- Auth: none declared

## Request body

- TradeRequest
  - `wallet` string, required
  - `asset` string, required
  - `contract_address` string, required
  - `side` string, required
  - `amount` number, required
  - `max_slippage_bps` integer
  - `deadline` integer, nullable
  - `request_id` string, nullable
  - `allow_unregistered` boolean

## Response `200`

Successful Response

- Verdict
  - `decision` string, required
  - `reasons` string[], required
  - `tier` integer, required
  - `max_trade_usd` number, required
  - `calculated_notional_usd` number, required
  - `price_usd` number
  - `price_source` string
  - `risk_score` integer
  - `timestamp` integer, required
  - `request_id` string, nullable
  - `contract_risk` object, nullable
  - `daily_pnl_usd` number
  - `audit_hash` string, nullable
  - `audit_seq` integer, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/collarguardrail/apis/colr-guardrail-api.md) · [All operations](https://skmtc.dev/collarguardrail/apis/colr-guardrail-api/llms.txt) · [OpenAPI document](https://skmtc.dev/collarguardrail/apis/colr-guardrail-api/revisions/886ff182684c?raw)