---
title: "List insights"
method: GET
path: "/api/v1/insights"
tags: ["Editorial"]
---

# List insights

`GET /api/v1/insights`

AI-generated market insights, paginated. Filter by `type`, a related `coin` slug
or free-text `search`; `locale` picks the headline/summary language with English
fallback.

## Query parameters

- `page` integer, nullable — Page number (1-based).
- `per_page` integer, nullable — Rows per page (1–50, default 20).
- `locale` string, nullable — Content language (falls back to English).
- `type` string, nullable — Filter by insight type: `per_asset`, `market_overview` or `narrative`.
- `coin` string, nullable — Filter to insights about this coin slug.
- `search` string, nullable — Free-text match on the headline.
- `sort` string, nullable — Sort order: `first_reported` (default) or `last_updated`.

---

[API](https://skmtc.net/bitculator/apis/bitculator-data-api.md) · [All operations](https://skmtc.net/bitculator/apis/bitculator-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitculator/bitculator-data-api/revisions/ed1378af68b6/schema)