# IPOSignal API

US IPO data read from SEC filings and exchange calendars: deal terms, financial statements, valuation metrics, sentiment, and dated events such as lock-up expiries. Figures come from filings and market feeds, not from a language model, and a figure that cannot be sourced is left out.

The same data is available two ways:

- **HTTP**: `GET https://iposignal.xyz/api/agent/...`, described by an [OpenAPI document](https://iposignal.xyz/openapi.json).
- **MCP**: a Model Context Protocol server at `https://iposignal.xyz/api/oauth/mcp`, for Claude, ChatGPT, Cursor, VS Code and other MCP clients. They sign you in with your IPOSignal account.

## What you can get

| Data | HTTP endpoint | MCP tool | Price per call |
| --- | --- | --- | --- |
| Companies with financial statements | `/api/agent/companies` | `lookup_companies_with_financials` | Free |
| IPO snapshot by ticker | `/api/agent/ipo/by-symbol/{symbol}` | `get_ipo_snapshot` | $0.01 |
| IPO snapshot by id | `/api/agent/ipo/{id}` | `get_ipo_snapshot` | $0.01 |
| Financial statements | `/api/agent/financials/by-symbol/{symbol}` | `get_company_financials` | $0.01 |
| Live valuation metrics | `/api/agent/company-metrics` | `get_company_metrics` | $0.02 |
| IPO market sentiment | `/api/agent/ipo-sentiment` | `get_ipo_sentiment` | $0.01 |
| Social sentiment for one IPO | `/api/agent/social-sentiment` | `get_ipo_social_sentiment` | $0.01 |
| IPO events calendar | `/api/agent/ipo-events` | `get_ipo_events` | $0.02 |

Three more MCP tools are free and have no HTTP endpoint: `get_ipo_overview`, `get_ipo_pipeline` and `get_ipo_filings`. See [MCP server](https://iposignal.xyz/docs/mcp.md).

## Paying for a call

A paid call is covered by your account or by a payment. Either way, you are charged only when a call delivers a result: a not-found, a bad request or a server error costs nothing.

- **Your account.** Any account includes 250 calls a month, and a subscription 10,000. Use it with an API key, or by signing in from an MCP client.
- **x402.** No account: the endpoint answers `402` with a price, your client pays in USDC on Base, and the request is retried. Built for autonomous agents that hold a wallet.

Details are in [Authentication](https://iposignal.xyz/docs/authentication.md).

## Quickstart

The company directory is free and needs no key:

```bash
curl "https://iposignal.xyz/api/agent/companies?q=circle"
```

Then [create a key](https://iposignal.xyz/account) and call a paid endpoint:

```bash
curl -H "Authorization: Bearer ips_live_YOUR_KEY" \
  "https://iposignal.xyz/api/agent/ipo/by-symbol/CRCL"
```

[Getting started](https://iposignal.xyz/docs/getting-started.md) walks through both, and through connecting an MCP client.

## For coding agents

Paste this into Claude Code, Cursor or another coding agent to set a project up:

```text
Read https://iposignal.xyz/skill.md and https://iposignal.xyz/llms.txt.
Add an "IPOSignal API" section to AGENTS.md (or CLAUDE.md) that records: the base URL,
that the key is read from the IPOSIGNAL_API_KEY environment variable and never hard-coded,
which endpoint answers which question, and that only a 200 response is charged.
Then call https://iposignal.xyz/api/agent/companies?q=circle to confirm the setup works.
```

## Machine-readable

- [openapi.json](https://iposignal.xyz/openapi.json): the HTTP API as OpenAPI 3.1.
- [skill.md](https://iposignal.xyz/skill.md): how to call the API correctly, written for an agent.
- [llms.txt](https://iposignal.xyz/llms.txt): what the site is and where everything lives.
- [llms-full.txt](https://iposignal.xyz/llms-full.txt): every docs page in one file.
- Any docs page as Markdown: add `.md` to its URL.
- [Agent card](https://iposignal.xyz/.well-known/agent-card.json): the A2A descriptor.