IPOSignal

{
  "name": "IPOSignal",
  "version": "1.1.0",
  "description": "Premium IPO intelligence for smarter investment decisions — comprehensive company profiles, AI-powered research with valuation analysis and competitor benchmarking, SEC filing details, per-company financial statements with derived key metrics straight from SEC iXBRL filings, and a proprietary daily sentiment score measuring real-time market appetite for new listings.",
  "protocolVersion": "1.0.0",
  "supportedInterfaces": [
    {
      "url": "https://iposignal.xyz/api/a2a",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "1.0.0"
    }
  ],
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "extendedAgentCard": false
  },
  "defaultInputModes": [
    "application/json",
    "text/plain"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "provider": {
    "organization": "IPOSignal",
    "url": "https://iposignal.xyz"
  },
  "documentationUrl": "https://iposignal.xyz/agents",
  "iconUrl": "https://iposignal.xyz/icons/icon-512x512.png",
  "protocol": "agent-card+json",
  "documentation": "https://docs.x402.org/core-concepts/http-402",
  "endpoints": {
    "agentDiscovery": "https://iposignal.xyz/api/a2a",
    "mcp": "https://iposignal.xyz/api/mcp",
    "ipoSnapshotById": "https://iposignal.xyz/api/agent/ipo/{id}",
    "ipoSnapshotBySymbol": "https://iposignal.xyz/api/agent/ipo/by-symbol/{symbol}",
    "ipoSentiment": "https://iposignal.xyz/api/agent/ipo-sentiment",
    "socialSentiment": "https://iposignal.xyz/api/agent/social-sentiment",
    "companiesLookup": "https://iposignal.xyz/api/agent/companies",
    "financialsBySymbol": "https://iposignal.xyz/api/agent/financials/by-symbol/{symbol}",
    "companyMetrics": "https://iposignal.xyz/api/agent/company-metrics"
  },
  "payment": {
    "protocol": "x402",
    "version": 1,
    "note": "When X402_ENABLED=true, IPO snapshot and financials HTTP routes return 402 with PAYMENT-REQUIRED until PAYMENT-SIGNATURE is verified via facilitator. The companies lookup is free.",
    "headers": {
      "paymentRequired": "PAYMENT-REQUIRED",
      "paymentSignature": "PAYMENT-SIGNATURE",
      "paymentResponse": "PAYMENT-RESPONSE",
      "devBypass": "x-x402-dev-bypass"
    },
    "prices": {
      "currency": "USDC",
      "ipoSnapshot": "$0.01",
      "financials": "$0.01",
      "companyMetrics": "$0.02",
      "socialSentiment": "$0.01"
    },
    "envPricing": [
      "X402_NETWORK",
      "X402_PAY_TO",
      "X402_ASSET",
      "X402_ASSET_EIP712_NAME",
      "X402_ASSET_EIP712_VERSION"
    ]
  },
  "skills": [
    {
      "id": "lookup_companies_with_financials",
      "description": "Free directory of companies with SEC iXBRL financial statements available. Optionally filter with ?q= by ticker or company name. Returns ticker, company, CIK, the latest reported period end, and pre/post-IPO period counts — use it to discover which tickers the get_company_financials skill can return.",
      "pricing": "Free — no payment required.",
      "http": {
        "list": {
          "method": "GET",
          "path": "https://iposignal.xyz/api/agent/companies"
        },
        "search": {
          "method": "GET",
          "path": "https://iposignal.xyz/api/agent/companies?q={query}"
        }
      },
      "name": "Company directory lookup",
      "tags": [
        "finance",
        "sec",
        "discovery",
        "free"
      ]
    },
    {
      "id": "get_company_financials",
      "description": "Retrieve a company's financial statements extracted directly from SEC iXBRL filings (pre- and post-IPO 10-K/10-Q/20-F), including tagged income-statement, balance-sheet, and cash-flow line items, reporting currency with USD FX, interim figures annualized to 12 months, and derived key metrics (gross/operating/net margin, FCF margin, revenue growth, leverage, ROE, ROA). Look up by ticker symbol.",
      "pricing": "Pay-per-request via X402 protocol ($0.01 USDC on Base). MCP tool access included at no additional cost.",
      "http": {
        "bySymbol": {
          "method": "GET",
          "path": "https://iposignal.xyz/api/agent/financials/by-symbol/{symbol}"
        }
      },
      "name": "SEC financial statements",
      "tags": [
        "finance",
        "sec",
        "xbrl",
        "fundamentals"
      ]
    },
    {
      "id": "get_company_metrics",
      "description": "Live valuation metrics for ANY US-listed company (not just IPOs), computed from primary sources: SEC XBRL companyfacts TTM fundamentals (revenue, net income, EBITDA, debt, cash, shares outstanding) plus the latest market close. Returns multiples (P/E, P/S, EV/Revenue, EV/EBITDA), derivations (PEG, earnings/sales/EBITDA yields, net-debt/EBITDA), margins, and YoY growth — the same computation the IPOSignal valuation pipeline uses for peer benchmarking, with the convention stated in every response. Look up by ticker symbol (any SEC-mapped registrant) or company name (resolves Nasdaq/NYSE listings).",
      "pricing": "Pay-per-request via X402 protocol ($0.02 USDC on Base). MCP tool access included at no additional cost.",
      "http": {
        "bySymbol": {
          "method": "GET",
          "path": "https://iposignal.xyz/api/agent/company-metrics?symbol={symbol}"
        },
        "byName": {
          "method": "GET",
          "path": "https://iposignal.xyz/api/agent/company-metrics?name={companyName}"
        }
      },
      "name": "Live valuation metrics",
      "tags": [
        "finance",
        "valuation",
        "equities",
        "metrics"
      ]
    },
    {
      "id": "get_ipo_snapshot",
      "description": "Retrieve a complete IPO company profile including deal terms, pricing range, SEC registration, AI-generated research with valuation models, competitor benchmarking, underwriter ratings, and risk analysis. Look up by ticker symbol, CIK number, or company ID.",
      "pricing": "Pay-per-request via X402 protocol (USDC on Base). MCP tool access included at no additional cost.",
      "http": {
        "byId": {
          "method": "GET",
          "path": "https://iposignal.xyz/api/agent/ipo/{id}"
        },
        "bySymbol": {
          "method": "GET",
          "path": "https://iposignal.xyz/api/agent/ipo/by-symbol/{symbol}"
        }
      },
      "name": "IPO company snapshot",
      "tags": [
        "ipo",
        "finance",
        "sec",
        "research"
      ]
    },
    {
      "id": "get_ipo_sentiment",
      "description": "Access IPOSignal's proprietary market sentiment score (-100 to +100) with daily trend data. Measures how well recent IPOs are performing post-listing — use it to time entries, gauge investor appetite for new offerings, and identify favorable IPO windows.",
      "pricing": "Pay-per-request via X402 protocol (USDC on Base). MCP tool access included at no additional cost.",
      "http": {
        "sentiment": {
          "method": "GET",
          "path": "https://iposignal.xyz/api/agent/ipo-sentiment"
        }
      },
      "name": "IPO market sentiment",
      "tags": [
        "ipo",
        "sentiment",
        "market"
      ]
    },
    {
      "id": "get_ipo_social_sentiment",
      "description": "Get the aggregate X/Twitter social-sentiment reading for a specific IPO (score -1 to +1, label, post tallies, and a one-line summary). Reflects how investors are discussing the stock on X. Returns the aggregate signal only — not the underlying posts. Look up by ticker symbol, CIK, or company ID.",
      "pricing": "Pay-per-request via X402 protocol ($0.01 USDC on Base). MCP tool access included at no additional cost.",
      "http": {
        "bySymbol": {
          "method": "GET",
          "path": "https://iposignal.xyz/api/agent/social-sentiment?symbol={symbol}"
        },
        "byCik": {
          "method": "GET",
          "path": "https://iposignal.xyz/api/agent/social-sentiment?cik={cik}"
        },
        "byId": {
          "method": "GET",
          "path": "https://iposignal.xyz/api/agent/social-sentiment?id={id}"
        }
      },
      "name": "IPO social sentiment",
      "tags": [
        "ipo",
        "sentiment",
        "social"
      ]
    }
  ]
}