---
title: "List agents"
method: GET
path: "/v1/agents"
tags: ["Agents"]
---

# List agents

`GET /v1/agents`

## Request

- Base URL: `https://api.marketintell.ai`
- URL: `https://api.marketintell.ai/v1/agents`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

List autonomous trading agents registered by the calling key. Each entry returns the agent id, name, goal, enabled state, soul (personality preset), trading_enabled flag, and last-run timestamp. Agents are owner-scoped. Pro tier or higher required.

## Response `200`

List of agents

- object
  - `agents` Agent[], required
    - `id` string, required
    - `name` string, required
    - `description` string
    - `enabled` boolean, required
    - `schedule` string: Cron expression governing scheduled execution (omitted = manual-only)
    - `model` string: LLM model id this agent uses (e.g. 'sonnet-4', 'opus-4')
    - `owner_id` string
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `last_run_at` string, date-time, nullable
    - `tools` string[]: Mastra tool ids the agent may call

---

[API](https://skmtc.dev/marketintell/apis/marketintell-api.md) · [All operations](https://skmtc.dev/marketintell/apis/marketintell-api/llms.txt) · [OpenAPI document](https://skmtc.dev/marketintell/apis/marketintell-api/revisions/f3ef87afc41f?raw)