{"openapi":"3.1.0","info":{"title":"IPOSignal API","version":"1","summary":"US IPO data from SEC filings: deal terms, financial statements, valuation metrics, sentiment and dated events.","description":"Every figure is read from a filing or a market feed, not generated by a language model; a figure that cannot be sourced is omitted.\n\n**Paying for a call.** Paid endpoints accept either an API key or an x402 payment. An API key is free to create at https://iposignal.xyz/account and includes 250 calls a month, or 10,000 with a subscription. Without a key, a paid endpoint answers 402 with x402 terms (USDC on Base) and returns the payload once the payment settles. A request is charged only when it delivers a result.\n\nThe same data is available as MCP tools at https://iposignal.xyz/api/mcp. Guides: https://iposignal.xyz/docs.","x-guidance":"Call GET /api/agent/companies (free) to find covered tickers. Paid endpoints take Authorization: Bearer <API key>, or an x402 payment in the PAYMENT-SIGNATURE header after a 402. Only a 200 is charged. Full guide: https://iposignal.xyz/skill.md"},"externalDocs":{"description":"Guides and MCP setup","url":"https://iposignal.xyz/docs"},"servers":[{"url":"https://iposignal.xyz"}],"tags":[{"name":"Free","description":"No key and no payment."},{"name":"Paid","description":"An API key or an x402 payment per call."}],"paths":{"/api/agent/companies":{"get":{"operationId":"listCompanies","summary":"Companies with financial statements","description":"Directory of the companies we hold SEC iXBRL financial statements for. Use it to find which tickers the financials endpoint can return. Free, no key needed.\n\nSame payload as the MCP tool `lookup_companies_with_financials`.","tags":["Free"],"parameters":[{"name":"q","in":"query","description":"Filter by ticker or company name (case-insensitive substring). Omit to list every company.","schema":{"type":"string"},"example":"circle"},{"name":"limit","in":"query","description":"Page size, 1 to 500.","schema":{"type":"integer","minimum":1,"maximum":500,"default":200}},{"name":"offset","in":"query","description":"Rows to skip. Pass the previous response's nextOffset to fetch the next page.","schema":{"type":"integer","minimum":0,"default":0}}],"security":[],"responses":{"200":{"description":"The payload.","content":{"application/json":{"schema":{"type":"object","properties":{"version":{"type":"string","const":"1"},"count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Rows in this page."},"total":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Rows matching the query across all pages."},"offset":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Rows skipped before this page."},"limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Page size you asked for."},"nextOffset":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Pass as offset to get the next page. Null on the last page."},"data":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"symbol":{"type":["string","null"],"description":"Ticker symbol the company trades under now, upper case, e.g. CRCL."},"company":{"type":["string","null"],"description":"Registrant name as filed with the SEC, e.g. Circle Internet Group, Inc."},"cik":{"type":["string","null"],"description":"SEC Central Index Key: the registrant's permanent SEC identifier, as a 10-digit string with leading zeros, e.g. 0001876042."},"latestPeriodEnd":{"type":["string","null"],"description":"End date of the most recent period we hold, YYYY-MM-DD. Shows how current the statements are."},"preIpoCount":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"How many periods (annual and interim) we hold from before the listing, read from the registration statement. 0 when we hold none. The financials endpoint returns them as preIpoPeriods."},"postIpoCount":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"How many periods we hold from the 10-K, 10-Q and 20-F reports filed after the listing. 0 for a company that has not reported as a public company yet. Returned as postIpoPeriods."}},"additionalProperties":true}},{"type":"null"}],"description":"Companies we hold SEC financial statements for, sorted by ticker."}},"additionalProperties":true},"example":{"version":"1","count":1,"total":1,"offset":0,"limit":200,"nextOffset":null,"data":[{"symbol":"CRCL","company":"Circle Internet Group, Inc.","cik":"0001876042","latestPeriodEnd":"2026-09-30","preIpoCount":4,"postIpoCount":8}]}}}},"500":{"description":"Server error. Not charged. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/agent/ipo/by-symbol/{symbol}":{"get":{"operationId":"getIpoBySymbol","summary":"IPO snapshot by ticker","description":"The full profile of one IPO: deal terms, price range and final offer price, market capitalisation, SEC registration and prospectus details, filing history, lifecycle timeline, borrow fee, and research where available.\n\nSame payload as the MCP tool `get_ipo_snapshot`.","tags":["Paid"],"parameters":[{"name":"symbol","in":"path","required":true,"description":"US ticker symbol. Case-insensitive. Tickers get reassigned, so a response may carry a symbolNote.","schema":{"type":"string"},"example":"CRCL"}],"security":[{"apiKey":[]},{"apiKeyHeader":[]},{}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The payload. Charged, or counted against the key's quota, only now.","headers":{"X-API-Quota-Remaining":{"description":"Calls left this month. Present when an API key paid for the call.","schema":{"type":"integer"}},"PAYMENT-RESPONSE":{"description":"The x402 settlement receipt, base64 JSON. Present when the call was paid over x402.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["version","data"],"properties":{"version":{"type":"string","const":"1"},"data":{"type":"object","properties":{"company":{"type":["string","null"],"description":"Registrant name as filed with the SEC, e.g. Circle Internet Group, Inc."},"cik":{"type":["string","null"],"description":"SEC Central Index Key: the registrant's permanent SEC identifier, as a 10-digit string with leading zeros, e.g. 0001876042."},"symbol":{"type":["string","null"],"description":"Ticker symbol the company trades under now, upper case, e.g. CRCL."},"venue":{"type":["string","null"],"description":"Listing exchange: NASDAQ, NYSE, NYSEAMER (NYSE American) or OTC. Other venues verbatim."},"updatedAt":{"type":["string","null"],"description":"When any part of this record last changed, ISO 8601."},"ipoDetails":{"anyOf":[{"type":"object","properties":{"date":{"type":["string","null"],"description":"First trading day, YYYY-MM-DD. For a deal that has not listed, the scheduled date."},"dateSource":{"type":["string","null"],"description":"Where date comes from: observed-trading (a trade we observed on that day) or scheduled (an exchange calendar)."},"exchange":{"type":["string","null"],"description":"Listing exchange: NASDAQ, NYSE, NYSEAMER (NYSE American) or OTC. Other venues verbatim."},"shares":{"type":["number","null"],"description":"Shares offered in the deal. Not shares outstanding."},"priceRange":{"type":["string","null"],"description":"The filed price range as text, low to high, USD per share, e.g. $16.00-$18.00. Null once the final price is known."},"offerPrice":{"type":["number","null"],"description":"Final offer price, USD per share. Null until the deal has priced."},"marketCap":{"type":["number","null"],"description":"What the company was worth at the offer, USD: economic shares outstanding right after the offering × offer price. Not the amount raised (see offerSize)."},"marketCapSource":{"type":["string","null"],"description":"Where marketCap comes from: sec (share count from the filing), qra-prospectus (the final prospectus), scoop (IPOScoop), override (checked by hand). Null when unknown."},"offerSize":{"type":["number","null"],"description":"Gross proceeds, USD: shares offered × offer price. What the deal raised, not what the company is worth."},"issuer":{"type":["string","null"],"description":"Issuer line when it differs from company. Currently never set."}},"additionalProperties":true},{"type":"null"}],"description":"Deal facts for the IPO."},"registration":{"anyOf":[{"type":"object","properties":{"form":{"type":["string","null"],"description":"SEC form type: S-1, S-1/A, F-1, F-1/A, S-11 or S-11/A."},"url":{"type":["string","null"],"description":"The statement's main document on sec.gov."},"filingDate":{"type":["string","null"],"description":"Date the statement was filed, YYYY-MM-DD."},"acceptedDate":{"type":["string","null"],"description":"Time EDGAR accepted the filing, ISO 8601."},"effectivenessDate":{"type":["string","null"],"description":"Date the SEC declared the statement effective, YYYY-MM-DD. Currently always null: no source we read carries it."},"status":{"type":["string","null"],"description":"Registration status. Currently always null: no source we read carries it."}},"additionalProperties":true},{"type":"null"}],"description":"The registration statement the deal was sold on: the latest S-1, F-1 or S-11 (or amendment) filed on or before the listing date."},"filings":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"formType":{"type":["string","null"],"description":"SEC form type, e.g. S-1, S-1/A, 424B4, EFFECT, RW, 25-NSE."},"filingDate":{"type":["string","null"],"description":"Filing date, YYYY-MM-DD."},"acceptedDate":{"type":["string","null"],"description":"Time EDGAR accepted the filing, ISO 8601."},"accessionNumber":{"type":["string","null"],"description":"SEC accession number, the filing's unique id, e.g. 0001193125-25-132755."},"indexUrl":{"type":["string","null"],"description":"The filing's folder on sec.gov, listing every document in it."},"documentUrl":{"type":["string","null"],"description":"The filing's main document on sec.gov, when we resolved it."}},"additionalProperties":true}},{"type":"null"}],"description":"The company's SEC filings we track (registration statements, amendments, 424B prospectuses, delisting notices), oldest first."},"lifecycleEvents":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"status":{"type":["string","null"],"description":"filed, expected, prelisting, priced, trading, postponed, withdrawn, halted, halt_resumed, delisted or acquired."},"date":{"type":["string","null"],"description":"Date the status took effect, YYYY-MM-DD."}},"additionalProperties":true}},{"type":"null"}],"description":"The deal's dated status history, oldest first."},"borrowFee":{"anyOf":[{"type":"object","properties":{"feeRate":{"type":["number","null"],"description":"Annual borrow fee in percent, IBKR's unit: 0.25 means 0.25% a year, 35 means 35% a year."},"asOfDate":{"type":["string","null"],"description":"Date the rate was quoted, YYYY-MM-DD."}},"additionalProperties":true},{"type":"null"}],"description":"Latest indicative cost of borrowing the shares to sell short, from Interactive Brokers. Present once the stock trades and IBKR quotes it."},"research":{"anyOf":[{"type":"object","properties":{"summary":{"type":["string","null"],"description":"Summary of the company and the deal."},"competitors":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Named competitors."},"keyRisks":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"The main risks, one sentence each."},"useOfProceeds":{"type":["string","null"],"description":"What the company says it will do with the money raised."},"boardOfDirectors":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"name":{"type":["string","null"],"description":"Director's name."},"role":{"type":["string","null"],"description":"Role on the board, e.g. Chair, Independent Director."},"background":{"type":["string","null"],"description":"Short background, when the prospectus gives one."}},"additionalProperties":true}},{"type":"null"}],"description":"Directors named in the prospectus."},"isInvestmentVehicle":{"type":["boolean","null"],"description":"True for a trust, fund, ETF or SPAC rather than an operating company."},"interestLevel":{"type":["string","null"],"description":"Our read of how much attention the deal draws: High, Medium or Low."},"analystSector":{"type":["string","null"],"description":"Sector we classify the company in."},"analystSubsector":{"type":["string","null"],"description":"Subsector we classify the company in."},"sources":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"URLs the research cites."}},"additionalProperties":true},{"type":"null"}],"description":"Research written by our AI pipeline from the prospectus: summary, competitors, board, risks and valuation work. Text, not filed figures: check a number against the filing before relying on it. Absent until the pipeline has run for the deal."},"freedom24News":{"anyOf":[{"type":"object","properties":{"articles":{"anyOf":[{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}},{"type":"null"}],"description":"Articles as Freedom24 publishes them: title, provider, date, URL and text."},"lastSyncedAt":{"type":["string","null"],"description":"When we last fetched Freedom24's list for the company, ISO 8601."}},"additionalProperties":true},{"type":"null"}],"description":"News articles about the deal from Freedom24, when it covers the company."},"sec":{"anyOf":[{"type":"object","properties":{"category":{"type":["string","null"],"description":"SEC filer category, e.g. Non-accelerated filer, Emerging growth company."},"description":{"type":["string","null"],"description":"Industry from the company's SIC code, e.g. Services-Prepackaged Software."}},"additionalProperties":true},{"type":"null"}],"description":"How the SEC classifies the company."},"symbolNote":{"anyOf":[{"type":"object","properties":{"requestedSymbol":{"type":["string","null"],"description":"The ticker you asked for."},"servedCik":{"type":["string","null"],"description":"CIK of the company whose record this response holds."},"currentHolderCik":{"type":["string","null"],"description":"CIK of the company that holds the ticker today, when known."},"currentHolderName":{"type":["string","null"],"description":"Name of the company that holds the ticker today, when known."},"reason":{"type":["string","null"],"description":"Plain-language explanation of the mismatch."}},"additionalProperties":true},{"type":"null"}],"description":"Present only when the ticker you asked for has belonged to more than one company and the record served is not the current holder's. Absent on an ordinary lookup."}},"additionalProperties":true}}},"example":{"version":"1","data":{"company":"Circle Internet Group, Inc.","cik":"0001876042","symbol":"CRCL","venue":"NYSE","ipoDetails":{"date":"2025-06-05","exchange":"NYSE","shares":34000000,"offerPrice":31,"offerSize":1054000000,"marketCap":6898700000},"registration":{"form":"S-1/A","filingDate":"2025-06-02","effectivenessDate":null,"url":"https://www.sec.gov/Archives/edgar/data/1876042/000119312525132755/d737521ds1a.htm"},"filings":[{"formType":"S-1/A","filingDate":"2025-06-02","acceptedDate":null,"accessionNumber":"0001193125-25-132755","indexUrl":"https://www.sec.gov/Archives/edgar/data/1876042/000119312525132755/","documentUrl":"https://www.sec.gov/Archives/edgar/data/1876042/000119312525132755/d737521ds1a.htm"}],"lifecycleEvents":[{"status":"priced","date":"2025-06-05"}],"borrowFee":{"feeRate":0.2736,"asOfDate":"2026-05-22"}}}}}},"401":{"description":"The API key is unknown or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required: no key and no payment was sent, or the key's monthly quota is spent. The body and the PAYMENT-REQUIRED header carry the x402 terms.","headers":{"PAYMENT-REQUIRED":{"description":"The body, base64-encoded.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"404":{"description":"Nothing matched the request. Not charged and not counted against a key's quota.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error. Not charged. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/agent/ipo/{id}":{"get":{"operationId":"getIpoById","summary":"IPO snapshot by id","description":"The same profile as the by-ticker endpoint, addressed by the IPOSignal company id that other responses return. Use it when a ticker is ambiguous or not yet assigned.\n\nSame payload as the MCP tool `get_ipo_snapshot`.","tags":["Paid"],"parameters":[{"name":"id","in":"path","required":true,"description":"IPOSignal company id, 24 hexadecimal characters.","schema":{"type":"string","pattern":"^[0-9a-f]{24}$"}}],"security":[{"apiKey":[]},{"apiKeyHeader":[]},{}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The payload. Charged, or counted against the key's quota, only now.","headers":{"X-API-Quota-Remaining":{"description":"Calls left this month. Present when an API key paid for the call.","schema":{"type":"integer"}},"PAYMENT-RESPONSE":{"description":"The x402 settlement receipt, base64 JSON. Present when the call was paid over x402.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["version","data"],"properties":{"version":{"type":"string","const":"1"},"data":{"type":"object","properties":{"company":{"type":["string","null"],"description":"Registrant name as filed with the SEC, e.g. Circle Internet Group, Inc."},"cik":{"type":["string","null"],"description":"SEC Central Index Key: the registrant's permanent SEC identifier, as a 10-digit string with leading zeros, e.g. 0001876042."},"symbol":{"type":["string","null"],"description":"Ticker symbol the company trades under now, upper case, e.g. CRCL."},"venue":{"type":["string","null"],"description":"Listing exchange: NASDAQ, NYSE, NYSEAMER (NYSE American) or OTC. Other venues verbatim."},"updatedAt":{"type":["string","null"],"description":"When any part of this record last changed, ISO 8601."},"ipoDetails":{"anyOf":[{"type":"object","properties":{"date":{"type":["string","null"],"description":"First trading day, YYYY-MM-DD. For a deal that has not listed, the scheduled date."},"dateSource":{"type":["string","null"],"description":"Where date comes from: observed-trading (a trade we observed on that day) or scheduled (an exchange calendar)."},"exchange":{"type":["string","null"],"description":"Listing exchange: NASDAQ, NYSE, NYSEAMER (NYSE American) or OTC. Other venues verbatim."},"shares":{"type":["number","null"],"description":"Shares offered in the deal. Not shares outstanding."},"priceRange":{"type":["string","null"],"description":"The filed price range as text, low to high, USD per share, e.g. $16.00-$18.00. Null once the final price is known."},"offerPrice":{"type":["number","null"],"description":"Final offer price, USD per share. Null until the deal has priced."},"marketCap":{"type":["number","null"],"description":"What the company was worth at the offer, USD: economic shares outstanding right after the offering × offer price. Not the amount raised (see offerSize)."},"marketCapSource":{"type":["string","null"],"description":"Where marketCap comes from: sec (share count from the filing), qra-prospectus (the final prospectus), scoop (IPOScoop), override (checked by hand). Null when unknown."},"offerSize":{"type":["number","null"],"description":"Gross proceeds, USD: shares offered × offer price. What the deal raised, not what the company is worth."},"issuer":{"type":["string","null"],"description":"Issuer line when it differs from company. Currently never set."}},"additionalProperties":true},{"type":"null"}],"description":"Deal facts for the IPO."},"registration":{"anyOf":[{"type":"object","properties":{"form":{"type":["string","null"],"description":"SEC form type: S-1, S-1/A, F-1, F-1/A, S-11 or S-11/A."},"url":{"type":["string","null"],"description":"The statement's main document on sec.gov."},"filingDate":{"type":["string","null"],"description":"Date the statement was filed, YYYY-MM-DD."},"acceptedDate":{"type":["string","null"],"description":"Time EDGAR accepted the filing, ISO 8601."},"effectivenessDate":{"type":["string","null"],"description":"Date the SEC declared the statement effective, YYYY-MM-DD. Currently always null: no source we read carries it."},"status":{"type":["string","null"],"description":"Registration status. Currently always null: no source we read carries it."}},"additionalProperties":true},{"type":"null"}],"description":"The registration statement the deal was sold on: the latest S-1, F-1 or S-11 (or amendment) filed on or before the listing date."},"filings":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"formType":{"type":["string","null"],"description":"SEC form type, e.g. S-1, S-1/A, 424B4, EFFECT, RW, 25-NSE."},"filingDate":{"type":["string","null"],"description":"Filing date, YYYY-MM-DD."},"acceptedDate":{"type":["string","null"],"description":"Time EDGAR accepted the filing, ISO 8601."},"accessionNumber":{"type":["string","null"],"description":"SEC accession number, the filing's unique id, e.g. 0001193125-25-132755."},"indexUrl":{"type":["string","null"],"description":"The filing's folder on sec.gov, listing every document in it."},"documentUrl":{"type":["string","null"],"description":"The filing's main document on sec.gov, when we resolved it."}},"additionalProperties":true}},{"type":"null"}],"description":"The company's SEC filings we track (registration statements, amendments, 424B prospectuses, delisting notices), oldest first."},"lifecycleEvents":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"status":{"type":["string","null"],"description":"filed, expected, prelisting, priced, trading, postponed, withdrawn, halted, halt_resumed, delisted or acquired."},"date":{"type":["string","null"],"description":"Date the status took effect, YYYY-MM-DD."}},"additionalProperties":true}},{"type":"null"}],"description":"The deal's dated status history, oldest first."},"borrowFee":{"anyOf":[{"type":"object","properties":{"feeRate":{"type":["number","null"],"description":"Annual borrow fee in percent, IBKR's unit: 0.25 means 0.25% a year, 35 means 35% a year."},"asOfDate":{"type":["string","null"],"description":"Date the rate was quoted, YYYY-MM-DD."}},"additionalProperties":true},{"type":"null"}],"description":"Latest indicative cost of borrowing the shares to sell short, from Interactive Brokers. Present once the stock trades and IBKR quotes it."},"research":{"anyOf":[{"type":"object","properties":{"summary":{"type":["string","null"],"description":"Summary of the company and the deal."},"competitors":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Named competitors."},"keyRisks":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"The main risks, one sentence each."},"useOfProceeds":{"type":["string","null"],"description":"What the company says it will do with the money raised."},"boardOfDirectors":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"name":{"type":["string","null"],"description":"Director's name."},"role":{"type":["string","null"],"description":"Role on the board, e.g. Chair, Independent Director."},"background":{"type":["string","null"],"description":"Short background, when the prospectus gives one."}},"additionalProperties":true}},{"type":"null"}],"description":"Directors named in the prospectus."},"isInvestmentVehicle":{"type":["boolean","null"],"description":"True for a trust, fund, ETF or SPAC rather than an operating company."},"interestLevel":{"type":["string","null"],"description":"Our read of how much attention the deal draws: High, Medium or Low."},"analystSector":{"type":["string","null"],"description":"Sector we classify the company in."},"analystSubsector":{"type":["string","null"],"description":"Subsector we classify the company in."},"sources":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"URLs the research cites."}},"additionalProperties":true},{"type":"null"}],"description":"Research written by our AI pipeline from the prospectus: summary, competitors, board, risks and valuation work. Text, not filed figures: check a number against the filing before relying on it. Absent until the pipeline has run for the deal."},"freedom24News":{"anyOf":[{"type":"object","properties":{"articles":{"anyOf":[{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}},{"type":"null"}],"description":"Articles as Freedom24 publishes them: title, provider, date, URL and text."},"lastSyncedAt":{"type":["string","null"],"description":"When we last fetched Freedom24's list for the company, ISO 8601."}},"additionalProperties":true},{"type":"null"}],"description":"News articles about the deal from Freedom24, when it covers the company."},"sec":{"anyOf":[{"type":"object","properties":{"category":{"type":["string","null"],"description":"SEC filer category, e.g. Non-accelerated filer, Emerging growth company."},"description":{"type":["string","null"],"description":"Industry from the company's SIC code, e.g. Services-Prepackaged Software."}},"additionalProperties":true},{"type":"null"}],"description":"How the SEC classifies the company."},"symbolNote":{"anyOf":[{"type":"object","properties":{"requestedSymbol":{"type":["string","null"],"description":"The ticker you asked for."},"servedCik":{"type":["string","null"],"description":"CIK of the company whose record this response holds."},"currentHolderCik":{"type":["string","null"],"description":"CIK of the company that holds the ticker today, when known."},"currentHolderName":{"type":["string","null"],"description":"Name of the company that holds the ticker today, when known."},"reason":{"type":["string","null"],"description":"Plain-language explanation of the mismatch."}},"additionalProperties":true},{"type":"null"}],"description":"Present only when the ticker you asked for has belonged to more than one company and the record served is not the current holder's. Absent on an ordinary lookup."}},"additionalProperties":true}}},"example":{"version":"1","data":{"company":"Circle Internet Group, Inc.","cik":"0001876042","symbol":"CRCL","venue":"NYSE","ipoDetails":{"date":"2025-06-05","exchange":"NYSE","shares":34000000,"offerPrice":31,"offerSize":1054000000,"marketCap":6898700000},"registration":{"form":"S-1/A","filingDate":"2025-06-02","effectivenessDate":null,"url":"https://www.sec.gov/Archives/edgar/data/1876042/000119312525132755/d737521ds1a.htm"},"filings":[{"formType":"S-1/A","filingDate":"2025-06-02","acceptedDate":null,"accessionNumber":"0001193125-25-132755","indexUrl":"https://www.sec.gov/Archives/edgar/data/1876042/000119312525132755/","documentUrl":"https://www.sec.gov/Archives/edgar/data/1876042/000119312525132755/d737521ds1a.htm"}],"lifecycleEvents":[{"status":"priced","date":"2025-06-05"}],"borrowFee":{"feeRate":0.2736,"asOfDate":"2026-05-22"}}}}}},"401":{"description":"The API key is unknown or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required: no key and no payment was sent, or the key's monthly quota is spent. The body and the PAYMENT-REQUIRED header carry the x402 terms.","headers":{"PAYMENT-REQUIRED":{"description":"The body, base64-encoded.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"404":{"description":"Nothing matched the request. Not charged and not counted against a key's quota.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error. Not charged. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/agent/financials/by-symbol/{symbol}":{"get":{"operationId":"getFinancialsBySymbol","summary":"Financial statements","description":"SEC iXBRL income statement, balance sheet and cash-flow line items for a company we cover, before and after its IPO, with margins, growth, leverage and return ratios per period. Interim periods carry annualised figures beside the reported ones.\n\nSame payload as the MCP tool `get_company_financials`.","tags":["Paid"],"parameters":[{"name":"symbol","in":"path","required":true,"description":"US ticker symbol. Case-insensitive. Tickers get reassigned, so a response may carry a symbolNote.","schema":{"type":"string"},"example":"CRCL"}],"security":[{"apiKey":[]},{"apiKeyHeader":[]},{}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The payload. Charged, or counted against the key's quota, only now.","headers":{"X-API-Quota-Remaining":{"description":"Calls left this month. Present when an API key paid for the call.","schema":{"type":"integer"}},"PAYMENT-RESPONSE":{"description":"The x402 settlement receipt, base64 JSON. Present when the call was paid over x402.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["version","data"],"properties":{"version":{"type":"string","const":"1"},"data":{"type":"object","properties":{"company":{"type":["string","null"],"description":"Registrant name as filed with the SEC, e.g. Circle Internet Group, Inc."},"symbol":{"type":["string","null"],"description":"Ticker symbol the company trades under now, upper case, e.g. CRCL."},"cik":{"type":["string","null"],"description":"SEC Central Index Key: the registrant's permanent SEC identifier, as a 10-digit string with leading zeros, e.g. 0001876042."},"fetchedAt":{"type":["string","null"],"description":"When we last read the statements from SEC, ISO 8601."},"preIpoPeriods":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"periodEndDate":{"type":["string","null"],"description":"Last day of the period, YYYY-MM-DD."},"periodStartDate":{"type":["string","null"],"description":"First day of the period, YYYY-MM-DD. Absent for a balance-sheet-only period."},"periodType":{"type":["string","null"],"description":"Annual, Quarterly, Semi-Annual, Nine Months Ended, Instant (a balance-sheet date with no income or cash-flow figures), or N-Day Period for any other length, e.g. 45-Day Period."},"durationMonths":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Length of the period in whole months: 12 for a year, 3 for a quarter, 6 or 9 for year-to-date, 0 for an Instant."},"currency":{"type":["string","null"],"description":"ISO 4217 currency the figures in metrics are in, e.g. USD, CNY. USD when absent."},"fxToUsd":{"type":["number","null"],"description":"USD per one unit of currency. Multiply a figure by it to get USD. Absent for USD."},"fxRateDate":{"type":["string","null"],"description":"Date the fxToUsd rate was taken, YYYY-MM-DD: the IPO date for pre-IPO periods, the period end for later ones."},"metrics":{"anyOf":[{"type":"object","additionalProperties":{"type":["number","null"]}},{"type":"null"}],"description":"Statement line items as filed, keyed by line name, in currency, whole units (not thousands). Only the lines the filing reports are present. Every key is listed under Line items."},"annualizedMetrics":{"anyOf":[{"type":"object","additionalProperties":{"type":["number","null"]}},{"type":"null"}],"description":"Interim periods only: the flow items in metrics scaled to twelve months, so a quarter compares with a year. Balance-sheet items are copied unchanged."},"annualizationMethod":{"type":["string","null"],"description":"How annualizedMetrics was made: ttm (last full year + this year to date − last year to date) or scaled (× 12 ÷ durationMonths)."},"derived":{"anyOf":[{"type":"object","additionalProperties":{"type":["number","null"]}},{"type":"null"}],"description":"Ratios computed from metrics, in percent: grossMarginPct, operatingMarginPct, netMarginPct, fcfMarginPct, revenueGrowthPct, debtToAssetsPct, equityRatioPct, returnOnEquityPct, returnOnAssetsPct, cashToAssetsPct. A ratio is absent when an input is missing."}},"additionalProperties":true}},{"type":"null"}],"description":"Periods reported in the registration statement, before the listing."},"postIpoPeriods":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"periodEndDate":{"type":["string","null"],"description":"Last day of the period, YYYY-MM-DD."},"periodStartDate":{"type":["string","null"],"description":"First day of the period, YYYY-MM-DD. Absent for a balance-sheet-only period."},"periodType":{"type":["string","null"],"description":"Annual, Quarterly, Semi-Annual, Nine Months Ended, Instant (a balance-sheet date with no income or cash-flow figures), or N-Day Period for any other length, e.g. 45-Day Period."},"durationMonths":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Length of the period in whole months: 12 for a year, 3 for a quarter, 6 or 9 for year-to-date, 0 for an Instant."},"currency":{"type":["string","null"],"description":"ISO 4217 currency the figures in metrics are in, e.g. USD, CNY. USD when absent."},"fxToUsd":{"type":["number","null"],"description":"USD per one unit of currency. Multiply a figure by it to get USD. Absent for USD."},"fxRateDate":{"type":["string","null"],"description":"Date the fxToUsd rate was taken, YYYY-MM-DD: the IPO date for pre-IPO periods, the period end for later ones."},"metrics":{"anyOf":[{"type":"object","additionalProperties":{"type":["number","null"]}},{"type":"null"}],"description":"Statement line items as filed, keyed by line name, in currency, whole units (not thousands). Only the lines the filing reports are present. Every key is listed under Line items."},"annualizedMetrics":{"anyOf":[{"type":"object","additionalProperties":{"type":["number","null"]}},{"type":"null"}],"description":"Interim periods only: the flow items in metrics scaled to twelve months, so a quarter compares with a year. Balance-sheet items are copied unchanged."},"annualizationMethod":{"type":["string","null"],"description":"How annualizedMetrics was made: ttm (last full year + this year to date − last year to date) or scaled (× 12 ÷ durationMonths)."},"derived":{"anyOf":[{"type":"object","additionalProperties":{"type":["number","null"]}},{"type":"null"}],"description":"Ratios computed from metrics, in percent: grossMarginPct, operatingMarginPct, netMarginPct, fcfMarginPct, revenueGrowthPct, debtToAssetsPct, equityRatioPct, returnOnEquityPct, returnOnAssetsPct, cashToAssetsPct. A ratio is absent when an input is missing."}},"additionalProperties":true}},{"type":"null"}],"description":"Periods from the 10-K, 10-Q and 20-F reports filed after the listing."},"symbolNote":{"anyOf":[{"type":"object","properties":{"requestedSymbol":{"type":["string","null"],"description":"The ticker you asked for."},"servedCik":{"type":["string","null"],"description":"CIK of the company whose record this response holds."},"currentHolderCik":{"type":["string","null"],"description":"CIK of the company that holds the ticker today, when known."},"currentHolderName":{"type":["string","null"],"description":"Name of the company that holds the ticker today, when known."},"reason":{"type":["string","null"],"description":"Plain-language explanation of the mismatch."}},"additionalProperties":true},{"type":"null"}],"description":"Present only when the ticker you asked for has belonged to more than one company and the record served is not the current holder's. Absent on an ordinary lookup."}},"additionalProperties":true}}},"example":{"version":"1","data":{"company":"Circle Internet Group, Inc.","symbol":"CRCL","cik":"0001876042","sec":{"periodicFinancials":{"fetchedAt":"2026-06-23T11:23:08.986Z"}}}}}}},"401":{"description":"The API key is unknown or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required: no key and no payment was sent, or the key's monthly quota is spent. The body and the PAYMENT-REQUIRED header carry the x402 terms.","headers":{"PAYMENT-REQUIRED":{"description":"The body, base64-encoded.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"404":{"description":"Nothing matched the request. Not charged and not counted against a key's quota.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error. Not charged. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/agent/company-metrics":{"get":{"operationId":"getCompanyMetrics","summary":"Live valuation metrics","description":"Valuation metrics for any US-listed company, not only IPOs: trailing-twelve-month fundamentals from SEC XBRL company facts and the latest market close, giving P/E, P/S, EV/Revenue, EV/EBITDA, PEG, yields, net debt to EBITDA, margins and year-on-year growth. The response states how each figure is computed. Provide exactly one of symbol or name.\n\nSame payload as the MCP tool `get_company_metrics`.","tags":["Paid"],"parameters":[{"name":"symbol","in":"query","description":"US ticker. Any ticker the SEC maps to a registrant.","schema":{"type":"string"},"example":"CRCL"},{"name":"name","in":"query","description":"Company name, for when the ticker is unknown. Resolves Nasdaq and NYSE listings only.","schema":{"type":"string"}}],"security":[{"apiKey":[]},{"apiKeyHeader":[]},{}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The payload. Charged, or counted against the key's quota, only now.","headers":{"X-API-Quota-Remaining":{"description":"Calls left this month. Present when an API key paid for the call.","schema":{"type":"integer"}},"PAYMENT-RESPONSE":{"description":"The x402 settlement receipt, base64 JSON. Present when the call was paid over x402.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["version","data"],"properties":{"version":{"type":"string","const":"1"},"data":{"type":"object","properties":{"listing":{"anyOf":[{"type":"object","properties":{"ticker":{"type":["string","null"],"description":"Ticker symbol the company trades under now, upper case, e.g. CRCL."},"name":{"type":["string","null"],"description":"Registrant name as filed with the SEC, e.g. Circle Internet Group, Inc."},"exchange":{"type":["string","null"],"description":"Listing exchange: NASDAQ, NYSE, NYSEAMER (NYSE American) or OTC. Other venues verbatim."},"cik":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"SEC Central Index Key as a number, without leading zeros, e.g. 1876042."}},"additionalProperties":true},{"type":"null"}],"description":"The company the query resolved to."},"priceClose":{"type":["number","null"],"description":"Latest daily closing price, USD per share."},"fundamentalsTtm":{"anyOf":[{"type":"object","properties":{"revenue":{"type":["number","null"],"description":"Revenue, USD."},"netIncome":{"type":["number","null"],"description":"Net income, USD. Negative for a loss."},"ebitda":{"type":["number","null"],"description":"Operating income + depreciation and amortization, USD."},"freeCashFlow":{"type":["number","null"],"description":"Operating cash flow − capital expenditures, USD."},"totalDebt":{"type":["number","null"],"description":"Debt at the latest balance sheet, USD: the combined debt figure when filed, else long-term debt + its current portion + short-term borrowings."},"cash":{"type":["number","null"],"description":"Cash and cash equivalents at the latest balance sheet, USD."},"sharesOutstanding":{"type":["number","null"],"description":"Shares outstanding used for marketCap. See sharesSource for which count it is."},"sharesSource":{"anyOf":[{"type":"object","properties":{"method":{"type":["string","null"],"description":"dei-total (the total on a 10-K or 10-Q cover), cover-per-class (the sum of the share classes on the cover) or weighted-average-basic (the EPS denominator, used only when no cover count exists)."},"asOf":{"type":["string","null"],"description":"Date the count is as of, YYYY-MM-DD."},"accession":{"type":["string","null"],"description":"Accession number of the filing the count was read from."},"classCount":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"cover-per-class only: how many share classes were summed."}},"additionalProperties":true},{"type":"null"}],"description":"Which share count sharesOutstanding is."}},"additionalProperties":true},{"type":"null"}],"description":"Trailing-twelve-month figures from SEC XBRL company facts, USD: the last full year + this year to date − last year to date."},"valuation":{"anyOf":[{"type":"object","properties":{"marketCap":{"type":["number","null"],"description":"priceClose × sharesOutstanding, USD."},"enterpriseValue":{"type":["number","null"],"description":"marketCap + totalDebt − cash, USD. Null unless both debt and cash are reported: an unreported figure is unknown, not 0."},"peRatio":{"type":["number","null"],"description":"Price to earnings: marketCap ÷ TTM net income. Null when net income is zero or negative."},"priceToSalesRatio":{"type":["number","null"],"description":"marketCap ÷ TTM revenue."},"evRevenueMultiple":{"type":["number","null"],"description":"enterpriseValue ÷ TTM revenue."},"evEbitda":{"type":["number","null"],"description":"enterpriseValue ÷ TTM EBITDA. Null when EBITDA is zero or negative."},"pegRatio":{"type":["number","null"],"description":"peRatio ÷ netIncomeGrowthPct. Null unless both are positive."},"earningsYieldPct":{"type":["number","null"],"description":"TTM net income ÷ marketCap, percent."},"salesYieldPct":{"type":["number","null"],"description":"TTM revenue ÷ marketCap, percent."},"revenueEvYieldPct":{"type":["number","null"],"description":"TTM revenue ÷ enterpriseValue, percent."},"ebitdaEvYieldPct":{"type":["number","null"],"description":"TTM EBITDA ÷ enterpriseValue, percent."},"freeCashFlowEvYieldPct":{"type":["number","null"],"description":"TTM free cash flow ÷ enterpriseValue, percent. Negative for a company burning cash."},"netDebtToEbitda":{"type":["number","null"],"description":"(totalDebt − cash) ÷ TTM EBITDA. Negative when cash exceeds debt; null unless both are reported."}},"additionalProperties":true},{"type":"null"}],"description":"Multiples at priceClose. A multiple is null when its denominator is missing or not positive."},"profile":{"anyOf":[{"type":"object","properties":{"grossMarginPct":{"type":["number","null"],"description":"Gross profit ÷ revenue."},"ebitdaMarginPct":{"type":["number","null"],"description":"EBITDA ÷ revenue."},"freeCashFlowMarginPct":{"type":["number","null"],"description":"Free cash flow ÷ revenue."},"revenueGrowthPct":{"type":["number","null"],"description":"Revenue in the latest fiscal year against the year before. Null when the earlier year is zero or negative."},"operatingIncomeGrowthPct":{"type":["number","null"],"description":"Operating income in the latest fiscal year against the year before. Null when the earlier year is zero or negative."},"netIncomeGrowthPct":{"type":["number","null"],"description":"Net income in the latest fiscal year against the year before. Null when the earlier year is zero or negative."}},"additionalProperties":true},{"type":"null"}],"description":"Margins over the trailing twelve months and growth over the last fiscal year, percent."},"sources":{"anyOf":[{"type":"object","properties":{"fundamentals":{"type":["string","null"],"description":"Source and method of fundamentalsTtm."},"price":{"type":["string","null"],"description":"Source of priceClose."},"convention":{"type":["string","null"],"description":"How EBITDA, enterprise value and PEG are defined."},"shares":{"type":["string","null"],"description":"Which share count was used, from which filing, and what it assumes."}},"additionalProperties":true},{"type":"null"}],"description":"Where each input came from, in words."},"unavailable":{"anyOf":[{"type":"object","properties":{"reason":{"type":["string","null"],"description":"no-price (no recent close), no-share-count (no share count filed yet) or no-sec-facts (SEC company facts unreadable)."},"detail":{"type":["string","null"],"description":"Plain-language explanation."}},"additionalProperties":true},{"type":"null"}],"description":"Present instead of the figures when the company resolved but no market cap can be struck."}},"additionalProperties":true}}},"example":{"version":"1","data":{"listing":{"ticker":"CRCL","name":"Circle Internet Group, Inc.","exchange":"NYSE","cik":1876042},"priceClose":64.08,"fundamentalsTtm":{"revenue":3030568000,"netIncome":462914000,"ebitda":459250000,"freeCashFlow":740687000,"totalDebt":null,"cash":1699951000,"sharesOutstanding":256553104},"valuation":{"marketCap":16438640139,"enterpriseValue":14738689139,"peRatio":35.51,"priceToSalesRatio":5.42,"evRevenueMultiple":4.86,"evEbitda":32.09,"pegRatio":null}}}}}},"400":{"description":"A parameter is missing or malformed. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"The API key is unknown or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required: no key and no payment was sent, or the key's monthly quota is spent. The body and the PAYMENT-REQUIRED header carry the x402 terms.","headers":{"PAYMENT-REQUIRED":{"description":"The body, base64-encoded.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"404":{"description":"Nothing matched the request. Not charged and not counted against a key's quota.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error. Not charged. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/agent/ipo-sentiment":{"get":{"operationId":"getIpoSentiment","summary":"IPO market sentiment","description":"The IPOSignal sentiment score: a daily reading from -100 to +100 of how recent IPOs are being received, with its trend over the last N days.\n\nSame payload as the MCP tool `get_ipo_sentiment`.","tags":["Paid"],"parameters":[{"name":"days","in":"query","description":"Trend window in days. Values outside 1 to 90 are clamped.","schema":{"type":"integer","minimum":1,"maximum":90,"default":14}}],"security":[{"apiKey":[]},{"apiKeyHeader":[]},{}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The payload. Charged, or counted against the key's quota, only now.","headers":{"X-API-Quota-Remaining":{"description":"Calls left this month. Present when an API key paid for the call.","schema":{"type":"integer"}},"PAYMENT-RESPONSE":{"description":"The x402 settlement receipt, base64 JSON. Present when the call was paid over x402.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["version","data"],"properties":{"version":{"type":"string","const":"1"},"data":{"type":"object","properties":{"current":{"anyOf":[{"type":"object","properties":{"date":{"type":["string","null"],"description":"Day the score is for, YYYY-MM-DD."},"score":{"type":["number","null"],"description":"-100 (extremely bearish) to +100 (extremely bullish). Built from how recent IPOs traded in their first 30 days: the level over the last 30 days and its change against the last 60."},"direction":{"type":["string","null"],"description":"bullish, bearish or neutral."},"strength":{"type":["string","null"],"description":"weak, moderate or strong."},"sampleSize":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"How many recent IPOs the score is computed from."},"reliable":{"type":["boolean","null"],"description":"False when sampleSize is below 5: too few IPOs to trust the score."},"computedAt":{"type":["string","null"],"description":"When the score was computed, ISO 8601."}},"additionalProperties":true},{"type":"null"}],"description":"The latest daily score."},"trend":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"date":{"type":["string","null"],"description":"Day the score is for, YYYY-MM-DD."},"score":{"type":["number","null"],"description":"-100 (extremely bearish) to +100 (extremely bullish). Built from how recent IPOs traded in their first 30 days: the level over the last 30 days and its change against the last 60."},"direction":{"type":["string","null"],"description":"bullish, bearish or neutral."},"strength":{"type":["string","null"],"description":"weak, moderate or strong."},"sampleSize":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"How many recent IPOs the score is computed from."},"reliable":{"type":["boolean","null"],"description":"False when sampleSize is below 5: too few IPOs to trust the score."},"computedAt":{"type":["string","null"],"description":"When the score was computed, ISO 8601."}},"additionalProperties":true}},{"type":"null"}],"description":"Daily scores for the window you asked for, newest first."},"summary":{"type":["string","null"],"description":"One sentence: the level, the direction over the last 7 days, and the sample size."}},"additionalProperties":true}}},"example":{"version":"1","data":{"current":{"date":"2026-09-21","score":62,"direction":"bullish","strength":"moderate","sampleSize":18,"reliable":true,"computedAt":"2026-09-21T06:00:00.000Z"},"trend":[{"date":"2026-09-21","score":62,"direction":"bullish","strength":"moderate","sampleSize":18,"reliable":true,"computedAt":"2026-09-21T06:00:00.000Z"}],"summary":"IPO market sentiment is moderately bullish and stable. Score: 62/100 based on 18 recent IPOs."}}}}},"401":{"description":"The API key is unknown or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required: no key and no payment was sent, or the key's monthly quota is spent. The body and the PAYMENT-REQUIRED header carry the x402 terms.","headers":{"PAYMENT-REQUIRED":{"description":"The body, base64-encoded.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"404":{"description":"Nothing matched the request. Not charged and not counted against a key's quota.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error. Not charged. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/agent/social-sentiment":{"get":{"operationId":"getSocialSentiment","summary":"Social sentiment for one IPO","description":"The aggregate X/Twitter reading for one IPO: a score from -1 to +1, a label, post tallies and a one-line summary. Taken once before listing and not refreshed: ageDays says how old it is, and reliable is false when too few posts back it. The posts themselves are not returned. Provide exactly one of symbol, cik or id.\n\nSame payload as the MCP tool `get_ipo_social_sentiment`.","tags":["Paid"],"parameters":[{"name":"symbol","in":"query","description":"US ticker.","schema":{"type":"string"},"example":"CRCL"},{"name":"cik","in":"query","description":"SEC Central Index Key, with or without leading zeros.","schema":{"type":"string"}},{"name":"id","in":"query","description":"IPOSignal company id.","schema":{"type":"string"}}],"security":[{"apiKey":[]},{"apiKeyHeader":[]},{}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The payload. Charged, or counted against the key's quota, only now.","headers":{"X-API-Quota-Remaining":{"description":"Calls left this month. Present when an API key paid for the call.","schema":{"type":"integer"}},"PAYMENT-RESPONSE":{"description":"The x402 settlement receipt, base64 JSON. Present when the call was paid over x402.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["version","data"],"properties":{"version":{"type":"string","const":"1"},"data":{"type":"object","properties":{"company":{"type":["string","null"],"description":"Registrant name as filed with the SEC, e.g. Circle Internet Group, Inc."},"symbol":{"type":["string","null"],"description":"Ticker symbol the company trades under now, upper case, e.g. CRCL."},"score":{"type":["number","null"],"description":"-1 (all posts bearish) to +1 (all posts bullish), across the posts read."},"label":{"type":["string","null"],"description":"Bullish, Neutral or Bearish."},"postCount":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"How many posts on X the reading is based on."},"positiveHits":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Posts scored positive."},"negativeHits":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Posts scored negative."},"summary":{"type":["string","null"],"description":"One-line summary of the conversation."},"analyzedAt":{"type":["string","null"],"description":"When the posts were read, ISO 8601."},"ageDays":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Whole days since analyzedAt. Readings are taken in the days before listing and not refreshed, so an old reading is the pre-IPO mood."},"reliable":{"type":["boolean","null"],"description":"False when too few posts back the reading: one post can set the label."},"symbolNote":{"anyOf":[{"type":"object","properties":{"requestedSymbol":{"type":["string","null"],"description":"The ticker you asked for."},"servedCik":{"type":["string","null"],"description":"CIK of the company whose record this response holds."},"currentHolderCik":{"type":["string","null"],"description":"CIK of the company that holds the ticker today, when known."},"currentHolderName":{"type":["string","null"],"description":"Name of the company that holds the ticker today, when known."},"reason":{"type":["string","null"],"description":"Plain-language explanation of the mismatch."}},"additionalProperties":true},{"type":"null"}],"description":"Present only when the ticker you asked for has belonged to more than one company and the record served is not the current holder's. Absent on an ordinary lookup."}},"additionalProperties":true}}},"example":{"version":"1","data":{"company":"Circle Internet Group, Inc.","symbol":"CRCL","score":0.41,"label":"bullish","postCount":128,"positiveHits":71,"negativeHits":22,"summary":"Discussion skews bullish on listing-day liquidity.","analyzedAt":"2026-09-21T09:12:00.000Z","ageDays":2,"reliable":true}}}}},"400":{"description":"A parameter is missing or malformed. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"The API key is unknown or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required: no key and no payment was sent, or the key's monthly quota is spent. The body and the PAYMENT-REQUIRED header carry the x402 terms.","headers":{"PAYMENT-REQUIRED":{"description":"The body, base64-encoded.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"404":{"description":"Nothing matched the request. Not charged and not counted against a key's quota.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error. Not charged. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/agent/ipo-events":{"get":{"operationId":"listIpoEvents","summary":"IPO events calendar","description":"Dated events across all US IPOs in a window: lock-up expiries with the lock-up length, quiet-period expiries, and listings with offer price, first-day open and close, first-day returns and lead managers. A window with no events is returned without charge.\n\nSame payload as the MCP tool `get_ipo_events`.","tags":["Paid"],"parameters":[{"name":"from","in":"query","description":"Window start, YYYY-MM-DD. Defaults to today.","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","description":"Window end, YYYY-MM-DD, inclusive and at most 366 days after from. Defaults to from + 30 days.","schema":{"type":"string","format":"date"}},{"name":"types","in":"query","description":"Comma-separated subset of lockup_expiry, quiet_period_expiry, listing. Defaults to all.","schema":{"type":"string"},"example":"lockup_expiry,listing"}],"security":[{"apiKey":[]},{"apiKeyHeader":[]},{}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The payload. Charged, or counted against the key's quota, only now.","headers":{"X-API-Quota-Remaining":{"description":"Calls left this month. Present when an API key paid for the call.","schema":{"type":"integer"}},"PAYMENT-RESPONSE":{"description":"The x402 settlement receipt, base64 JSON. Present when the call was paid over x402.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["version","data"],"properties":{"version":{"type":"string","const":"1"},"data":{"type":"object","properties":{"from":{"type":["string","null"],"description":"Window start, YYYY-MM-DD."},"to":{"type":["string","null"],"description":"Window end, YYYY-MM-DD, inclusive."},"types":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Event types included."},"count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Events returned."},"events":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"date":{"type":["string","null"],"description":"Day of the event, YYYY-MM-DD."},"type":{"type":["string","null"],"description":"lockup_expiry (insiders may start selling), quiet_period_expiry (underwriters' analysts may start publishing) or listing (first trading day)."},"company":{"type":["string","null"],"description":"Registrant name as filed with the SEC, e.g. Circle Internet Group, Inc."},"symbol":{"type":["string","null"],"description":"Ticker symbol the company trades under now, upper case, e.g. CRCL."},"cik":{"type":["string","null"],"description":"SEC Central Index Key: the registrant's permanent SEC identifier, as a 10-digit string with leading zeros, e.g. 0001876042."},"exchange":{"type":["string","null"],"description":"Listing exchange: NASDAQ, NYSE, NYSEAMER (NYSE American) or OTC. Other venues verbatim."},"lockupDays":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"lockup_expiry only: length of the lock-up in days, typically 180."},"listing":{"anyOf":[{"type":"object","properties":{"offerPrice":{"type":["number","null"],"description":"Offer price, USD per share. Null for a direct listing."},"firstDayOpen":{"type":["number","null"],"description":"First-day opening price, USD, as printed (not split-adjusted)."},"firstDayClose":{"type":["number","null"],"description":"First-day closing price, USD, as printed (not split-adjusted)."},"firstDayPopPct":{"type":["number","null"],"description":"(firstDayOpen − offerPrice) ÷ offerPrice, percent."},"firstDayCloseReturnPct":{"type":["number","null"],"description":"(firstDayClose − offerPrice) ÷ offerPrice, percent."},"leadManagers":{"type":["string","null"],"description":"Lead underwriters, as IPOScoop lists them."}},"additionalProperties":true},{"type":"null"}],"description":"listing events only: how the first day went."}},"additionalProperties":true}},{"type":"null"}],"description":"Events in date order."}},"additionalProperties":true}}},"example":{"version":"1","data":{"from":"2026-09-01","to":"2026-09-30","types":["lockup_expiry","listing"],"count":2,"events":[{"date":"2026-09-18","type":"listing","company":"Electra Therapeutics, Inc.","symbol":"ETRA","cik":"0002088082","exchange":"NASDAQ","listing":{"offerPrice":15,"firstDayOpen":15,"firstDayClose":13.25,"firstDayPopPct":0,"firstDayCloseReturnPct":-11.67,"leadManagers":"Jefferies/TD Cowen/Evercore ISI/Cantor"}},{"date":"2026-09-27","type":"lockup_expiry","company":"HMH Holding Inc","symbol":"HMH","cik":"0002021880","exchange":"NASDAQ","lockupDays":180}]}}}}},"400":{"description":"A parameter is missing or malformed. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"The API key is unknown or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required: no key and no payment was sent, or the key's monthly quota is spent. The body and the PAYMENT-REQUIRED header carry the x402 terms.","headers":{"PAYMENT-REQUIRED":{"description":"The body, base64-encoded.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"500":{"description":"Server error. Not charged. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","description":"An IPOSignal API key (ips_live_…), created at https://iposignal.xyz/account."},"apiKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key","description":"The same key, for clients that cannot set an Authorization header."}},"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"What went wrong, in a sentence."}}},"PaymentRequired":{"type":"object","description":"The x402 payment terms (https://docs.x402.org). `error` says why payment is needed, including a spent API quota.","required":["x402Version","accepts"],"properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"resource":{"type":"object","properties":{"url":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string"}}},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","description":"exact"},"network":{"type":"string","description":"CAIP-2 chain id; eip155:8453 is Base."},"amount":{"type":"string","description":"Price in the asset's base units; USDC has 6 decimals, so 10000 is $0.01."},"asset":{"type":"string","description":"Token contract address."},"payTo":{"type":"string","description":"Recipient address."},"maxTimeoutSeconds":{"type":"integer"}}}}}}}}}