# AstraEye Labs API

**Canonical:** https://apis.io/apis/astraeyelabs-io/astraeyelabs-io-api/  
**Provider:** AstraEye Labs — https://apis.io/providers/astraeyelabs-io/  
**Documentation:** https://astraeyelabs.io/research-api

AstraEye Labs API is one of 2 APIs that [AstraEye Labs](https://apis.io/providers/astraeyelabs-io/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

AstraEye Labs API as documented publicly: 24 operations. Contract generated from the documentation by API Evangelist (2026-11-01); not the provider's own document.

## Operations (24)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/assets/lookup` | Find assets by name or ticker. |
| GET | `/api/v1/research/analyses` | List analyses |
| GET | `/api/v1/research/analyses/{id}` | Retrieve an analysis |
| GET | `/api/v1/research/market-slices` | List market slices |
| GET | `/api/v1/research/projects` | List research projects |
| POST | `/api/v1/research/projects/archive` | Archive a research project. |
| POST | `/api/v1/research/projects/create` | Create a new research project. |
| POST | `/api/v1/research/projects/restore` | Restore a previously archived research project. |
| POST | `/api/v1/research/projects/update` | Update an existing research project. |
| GET | `/api/v1/research/projects/{id}` | Retrieve a project |
| GET | `/api/v1/research/projects/{id}/runs` | List a project's runs |
| GET | `/api/v1/research/projects/{id}/runs/{rungroupid}` | Retrieve a run |
| GET | `/api/v1/research/reports` | GET /api/v1/research/reports |
| GET | `/api/v1/research/reports/{id}` | Retrieve a report summary |
| GET | `/api/v1/research/reports/{id}/methodology` | Retrieve a report methodology |
| GET | `/api/v1/research/reports/{id}/quiz` | Returns the multiple-choice test written from the report, where it has one; a report without a test returns 404 not_found. |
| GET | `/api/v1/research/templates` | List templates |
| GET | `/api/v1/research/templates/{id}` | Retrieve a template |
| GET | `/api/v1/sage/messages` | Read messages in a SAGE conversation, oldest first. |
| POST | `/api/v1/sage/messages` | Send a message to SAGE and receive a reply. |
| GET | `/api/v1/sage/turns/{turnid}` | Get the state of a SAGE turn. |
| GET | `/api/v1/watchlist` | List the assets on your watchlist. |
| POST | `/api/v1/watchlist/add` | Add assets (or a market slice) to your watchlist. |
| POST | `/api/v1/watchlist/remove` | Remove assets from your watchlist. |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/astraeyelabs-io/openapi/_ae-authored/astraeyelabs-io-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/astraeyelabs-io/json-schema/astraeyelabs-io-get-api-v1-research-reports-id-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/astraeyelabs-io/json-schema/astraeyelabs-io-get-api-v1-research-analyses-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/astraeyelabs-io/json-schema/astraeyelabs-io-get-api-v1-research-templates-id-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/astraeyelabs-io/json-schema/astraeyelabs-io-get-api-v1-research-market-slices-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/astraeyelabs-io/json-schema/astraeyelabs-io-get-api-v1-research-projects-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/astraeyelabs-io/json-schema/astraeyelabs-io-get-api-v1-research-templates-response-schema.json

## Other AstraEye Labs APIs (1)

- [Research API](https://apis.io/apis/astraeyelabs-io/research-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/astraeyelabs-io/astraeyelabs-io-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/astraeyelabs-io/.