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. - 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.
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
402with 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.
Quickstart
The company directory is free and needs no key:
curl "https://iposignal.xyz/api/agent/companies?q=circle"
Then create a key and call a paid endpoint:
curl -H "Authorization: Bearer ips_live_YOUR_KEY" \
"https://iposignal.xyz/api/agent/ipo/by-symbol/CRCL"
Getting started 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:
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: the HTTP API as OpenAPI 3.1.
- skill.md: how to call the API correctly, written for an agent.
- llms.txt: what the site is and where everything lives.
- llms-full.txt: every docs page in one file.
- Any docs page as Markdown: add
.mdto its URL. - Agent card: the A2A descriptor.