Agent Data Broker

Return the enrichment record for one company: name, domain, industry, employee_count, description, last_updated (ISO 8601 UTC) and source. Call this when you already know the company's website domain or exact name and need firmographic details. Pass exactly one of `domain` (preferred; URLs like "https://www.acme.com/about" are normalized to "acme.com") or `name` (case-insensitive exact match). If you only have a partial name or a topic, call search_companies first. Returns error "not_found" when no record exists. Paid: $0.01 USDC per successful call on Base Sepolia via x402 (send the payment in request _meta "x402/payment"; an unpaid call returns the payment requirements). Lookups that fail, such as not_found, are not charged. For a free preview, use search_companies.

{
  "type": "object",
  "properties": {
    "domain": {
      "description": "Company website domain or URL, e.g. \"acme.com\"",
      "type": "string",
      "minLength": 1,
      "maxLength": 253
    },
    "name": {
      "description": "Exact company name, e.g. \"Acme Robotics\"",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Free preview. Find companies whose name, domain, industry or description contains the query (case-insensitive substring, not semantic). Use this to discover companies or resolve a partial name to a domain, then call get_company_enrichment (paid) for the full record. Returns { count, companies: [{ name, domain, industry }] }, best name matches first; an empty list means no matches. Default 10 results, max 25. Free.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 100,
      "description": "Text to look for, e.g. \"robotics\" or \"fintech\""
    },
    "limit": {
      "description": "Maximum results (default 10)",
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Free. Resolve a stock ticker, company name or CIK to SEC EDGAR registrants (US-listed public companies). Use this first when you have a ticker or a partial name and need the CIK for get_sec_filings or get_sec_financials. Matches exact ticker, then exact name, name prefix, then name substring. Returns { count, companies: [{ cik, ticker, name }] } (up to 10); an empty list means no match. Data: SEC company_tickers.json, which covers current exchange-listed registrants only.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Ticker, company name or CIK, e.g. \"AAPL\", \"apple\", \"320193\""
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List a public company's recent SEC EDGAR filings, newest first, with company metadata (name, tickers, exchanges, SIC industry code, state of incorporation, fiscal year end). Pass exactly one of `ticker` or `cik` (call sec_lookup_company first if you only have a name). Optional `form` filters to one form type, e.g. "10-K", "10-Q", "8-K", "DEF 14A". Each filing has accession_number, form, filing_date, report_date, description and a url to the primary document on sec.gov. Default 10 filings, max 50, from roughly the last year or 1,000 filings. Returns "not_found" for an unknown ticker or CIK. Paid: $0.01 USDC per successful call on Base Sepolia via x402 (same flow as get_company_enrichment); failed lookups are not charged.

{
  "type": "object",
  "properties": {
    "ticker": {
      "description": "Stock ticker, e.g. \"AAPL\"",
      "type": "string",
      "minLength": 1,
      "maxLength": 10
    },
    "cik": {
      "description": "SEC Central Index Key, e.g. \"320193\" or \"0000320193\"",
      "type": "string",
      "minLength": 1,
      "maxLength": 13
    },
    "form": {
      "description": "Only this form type, e.g. \"10-K\"",
      "type": "string",
      "minLength": 1,
      "maxLength": 20
    },
    "limit": {
      "description": "Maximum filings (default 10)",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Headline annual financials for a public company from its latest 10-K/20-F/40-F XBRL data on SEC EDGAR: revenue, net_income, operating_income, eps_diluted, total_assets, total_liabilities, stockholders_equity and cash. Each metric gives value, unit, the us-gaap concept used, period_start, period_end, fiscal_year, form, filed date and accession_number; a metric is null when the company doesn't report it under the standard us-gaap concept (common for IFRS filers and banks). Pass exactly one of `ticker` or `cik`. Returns "not_found" when EDGAR has no annual us-gaap data. Paid: $0.01 USDC per successful call on Base Sepolia via x402; failed lookups are not charged.

{
  "type": "object",
  "properties": {
    "ticker": {
      "description": "Stock ticker, e.g. \"AAPL\"",
      "type": "string",
      "minLength": 1,
      "maxLength": 10
    },
    "cik": {
      "description": "SEC Central Index Key, e.g. \"320193\" or \"0000320193\"",
      "type": "string",
      "minLength": 1,
      "maxLength": 13
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}