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/responsesruns 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/conversationslists your chat threads and their questions and answers, including the ones you started in the app. - Read research reports.
/v1/agent_resultsreturns the reports Marvin’s research agents wrote for you, such as earnings call summaries, as markdown. - Call the research tools directly.
/v1/toolslists, 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.
Start here
Section titled “Start here”- Quickstart: create an API key and make your first call.
- Authentication: how keys work and how to revoke one.
- 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.
Using an AI client instead
Section titled “Using an AI client instead”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.