# Build a research note

`POST https://api.getchord.xyz/v1/ask/report`

Source: https://getchord.xyz/docs/api-reference/operations/askreport/

Builds Chord's three-page research note for a token (HTML → PDF in the browser, plus Markdown) and returns links good for seven days.

## Request body (JSON)

| Field | Required | Type | Description |
| --- | --- | --- | --- |
| `token` | yes | string | Address or symbol on Arc. |
| `summary` | no | string | Optional analyst text to place on the first page. |

```json
{
  "token": "ARGUS"
}
```

## Response 200

- **400**: Invalid parameters — `error` names the check that failed (`INVALID_PARAMS`, `BAD_ADDRESS`, `BAD_LIMIT`, `BAD_HOURS`, …).
- **401**: Missing or unknown credential (`UNAUTHORIZED`).
- **404**: Nothing at this identity (`NOT_FOUND`, `UNKNOWN_TOKEN`, `NO_ROUTE`).
- **429**: Over the per-minute limit (`RATE_LIMIT_EXCEEDED`). Read `X-RateLimit-Reset` and back off.
- **503**: The lane behind this endpoint is not ready or not enabled here (`NOT_READY`, `CHAIN_NOT_ENABLED`, `NOT_ENABLED`, `*_UNAVAILABLE`). Retry later; do not treat it as an empty answer.