---
title: "Portfolio Checkup: A health check for everything in a wallet."
method: POST
path: "/agents/portfolio-checkup"
tags: ["Agents"]
---

# Portfolio Checkup: A health check for everything in a wallet.

`POST /agents/portfolio-checkup`

## Request

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

Reads a wallet's holdings live from the chain, runs the CoinGraph check on each tracked token, and measures concentration, how many days each position would take to exit at normal volume, and contract risks. Returns a health grade from A to F with fixes ranked by impact. Verdicts: A / B / C / D / F. Price: 10 tADA on testnet (pro).

## Request body

- object
  - `chain` 'eth' | 'bsc' | 'btc' | 'sol' | 'ada', required: Chain: eth (Ethereum), bsc (BNB Chain), btc (Bitcoin), sol (Solana), ada (Cardano)
  - `address` string, required

## 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)