Skip to content

Marvin Labs API

Marvin is an equity research analyst. The Marvin Labs API gives your code the same Marvin you use in the app:

  • Ask questions. POST /v1/responses runs one turn of Marvin and returns its answer. The endpoint follows the shape of OpenAI’s Responses API, so the OpenAI SDKs work against it unchanged.
  • Read conversations. /v1/conversations lists your chat threads and their questions and answers, including the ones you started in the app.
  • Read research reports. /v1/agent_results returns the reports Marvin’s research agents wrote for you, such as earnings call summaries, as markdown.
  • Call the research tools directly. /v1/tools lists, searches and reads a company’s filings and reports, and queries its reported financials, with the same tools Marvin uses in a chat.

Every call acts as you: it sees what you can see in the app, and credits are booked to your account.

  1. Quickstart: create an API key and make your first call.
  2. Authentication: how keys work and how to revoke one.
  3. Long-running requests: a turn can take minutes. Read this before you set client timeouts.

Then Errors, Rate limits and Credits cover what can go wrong and what it costs. The API reference lists every endpoint with its request and response schemas.

To ask Marvin from Claude, ChatGPT or Claude Code, you don’t need the API: add the hosted Marvin MCP server, https://app-api.marvin-labs.com/v1/mcp, as a connector and sign in with your Marvin account. Setup steps are in the Marvin MCP README.