---
title: "Trade Gatekeeper: The check every trade passes before it is placed."
method: POST
path: "/agents/trade-gatekeeper"
tags: ["Agents"]
---

# Trade Gatekeeper: The check every trade passes before it is placed.

`POST /agents/trade-gatekeeper`

## Request

- Base URL: `https://coingraph.ai/api/v1`
- URL: `https://coingraph.ai/api/v1/agents/trade-gatekeeper`
- Auth: none declared

Give it a token, an order size and optionally your rules. It runs the CoinGraph check, measures the real on-chain price impact of your size (DEX aggregator quote) against order-book depth and daily volume, reads leverage, onchain flows and contract risk, and returns ALLOW, REDUCE (with the largest safe size) or BLOCK, with every reason sourced. Verdicts: ALLOW / REDUCE / BLOCK. Price: 5 tADA on testnet (premium).

## Request body

- object
  - `token` string, required: Token: CoinGecko id (chainlink), symbol (LINK) or contract address
  - `size_usd` number, required: Order size in USD
  - `side` 'buy' | 'sell', required
  - `max_impact_pct` number: Largest acceptable price impact; default 1% for top-20 tokens, 2% otherwise
  - `policy` object
    - `min_depth_usd` number
    - `max_top10_holder_pct` number
    - `max_funding_pct` number
    - `max_exchange_inflow_usd` number
    - `allow_mint_authority` boolean

## Response `201`

Agent run

- object
  - `object` 'agent_run', required
  - `id` string, nullable
  - `as_of` string, date-time, required
  - `data` AgentRun, required
    - `run_id` string
    - `agent` string
    - `verdict` string
    - `summary` string
    - `result` object
    - `reasons` unknown[]
      - unknown
    - `warnings` unknown[]
      - unknown
    - `hash` string
    - `verify_url` string
  - `sources` Source[], required
    - `provider` string
    - `endpoint` string
    - `as_of` string, date-time, nullable

## Other responses

- `400`: Error
- `402`: Error
- `404`: Error
- `429`: Error

---

[API](https://skmtc.dev/coingraph/apis/coingraph-api.md) · [All operations](https://skmtc.dev/coingraph/apis/coingraph-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coingraph/apis/coingraph-api/revisions/55d33f7ec7a8?raw)