---
title: "Should you act on this token right now? (with your size and rules)"
method: POST
path: "/evaluate"
tags: ["Decide"]
---

# Should you act on this token right now? (with your size and rules)

`POST /evaluate`

## Request

- Base URL: `https://coingraph.ai/api/v1`
- URL: `https://coingraph.ai/api/v1/evaluate`
- Auth: none declared

Same verdict, scored against your order size (vs depth and daily volume) and your policy rules. **Premium tier:** 10 free calls a day, then 5 tADA per call via x402 on Cardano preprod (402 Payment Required → pay → retry with PAYMENT-SIGNATURE); design partners send an API key instead.

## Request body

- EvaluateRequest
  - `token` string, required
  - `size_usd` number: Your intended order size in USD
  - `policy` object
    - `max_unlock_pct` number
    - `min_depth_usd` number
    - `allow_mint_authority` boolean
    - `max_top10_holder_pct` number
    - `max_funding_pct` number
    - `max_exchange_inflow_usd` number

## Response `201`

Evaluation

- object
  - `object` 'evaluation', required
  - `id` string, nullable
  - `as_of` string, date-time, required
  - `data` Evaluation, required
    - `verdict` 'proceed' | 'caution' | 'avoid'
    - `confidence` number
    - `dimensions` object
    - `reasons` unknown[]
      - unknown
    - `size_check` object, nullable
    - `policy_check` object, nullable
    - `watch_next` 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)