Skip to content
Eden Engine

US Company Lookup (SEC EDGAR — by CIK, Ticker, or Name)

omnial/x402-us-company-data

Given a US company's SEC CIK number, stock ticker, or name, returns its SEC EDGAR registration record: legal name, CIK, EIN, SIC industry code and description, state, registered address, fiscal year end, entity type, filing status, and — for listed companies — ticker and exchange. A name that cannot be confidently resolved errors instead of guessing, unless the caller opts into a best-effort match.

activeper callv4

Price

$0.0811 per call

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.00.

Data source

SEC EDGAR

Data from SEC EDGAR.

Use it

Your AI assistant does the work: it finds this tool, shows you the price first, runs it, and you are charged when the run finishes. There is nothing to set up for this tool in particular.

Connect once and your AI can find and run this tool, and any other it needs.

For developers: the calls your assistant makes
agent
// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/x402-us-company-data" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/x402-us-company-data" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/x402-us-company-data", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/x402-us-company-data", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

ChargePrice
Per call
$0.0811
Updated
Nov 6, 2026

Input and output schemas

Input schema
input_schema.json
{
  "type": "object",
  "anyOf": [
    {
      "required": [
        "ticker"
      ]
    },
    {
      "required": [
        "cik"
      ]
    },
    {
      "required": [
        "company_name"
      ]
    },
    {
      "required": [
        "company"
      ]
    }
  ],
  "properties": {
    "cik": {
      "type": "string",
      "description": "SEC CIK number. Alternate to 'company' — same resolution rules apply."
    },
    "ticker": {
      "type": "string",
      "description": "Stock ticker symbol. Alternate to 'company' — same resolution rules apply."
    },
    "company": {
      "type": "string",
      "description": "CIK number, ticker symbol, or company name. Resolution order: exact CIK match, then exact ticker match, then exact company-name match (both via the SEC ticker/title map — no LLM call), then a best-effort LLM name extraction + SEC full-text filing search as a last resort (gated by match_confidence / allow_low_confidence below)."
    },
    "company_name": {
      "type": "string",
      "description": "US company name. Alternate to 'company' — same resolution rules apply."
    },
    "allow_low_confidence": {
      "type": "boolean",
      "default": false,
      "description": "If true, return the best-effort match even when the name could not be confidently resolved (match_confidence \"low\"). Default false — a low-confidence name lookup errors instead of returning a possibly-wrong company identity, so it can't silently feed downstream screening. Only relevant to the LLM+full-text-search fallback path; exact CIK/ticker/title-map resolutions are always match_confidence \"exact\" and are never gated by this flag."
    }
  },
  "additionalProperties": false
}
Output schema
output_schema.json
{
  "type": "object",
  "properties": {
    "cik": {
      "type": "string",
      "description": "SEC Central Index Key, zero-padded, e.g. '0000320193'."
    },
    "ein": {
      "type": "string",
      "description": "IRS Employer Identification Number on file with the SEC, digits only."
    },
    "sic": {
      "type": "string",
      "description": "SEC Standard Industrial Classification code."
    },
    "state": {
      "type": "string",
      "description": "US state abbreviation of the registered address."
    },
    "status": {
      "type": "string",
      "description": "e.g. 'active'."
    },
    "ticker": {
      "type": "string",
      "description": "Stock ticker, observed on the one publicly-listed company captured (Apple). A privately-held company resolved by CIK or name has not been observed and may not carry this field at all."
    },
    "address": {
      "type": "string",
      "description": "The company's registered address on file with the SEC, single-line."
    },
    "exchange": {
      "type": "string",
      "description": "Listing exchange, e.g. 'Nasdaq'. Same caveat as `ticker` -- only confirmed present for a publicly-listed company."
    },
    "error_code": {
      "type": "string",
      "description": "Present only on an unresolvable/not-found lookup, e.g. 'HTTP_400' for a company name that could not be matched to any SEC filer."
    },
    "entity_type": {
      "type": "string",
      "description": "e.g. 'operating'."
    },
    "company_name": {
      "type": "string",
      "description": "The resolved legal entity name."
    },
    "error_message": {
      "type": "string",
      "description": "Present only on an unresolvable/not-found lookup, a short human-readable explanation paired with `error_code`."
    },
    "searched_name": {
      "type": "string",
      "description": "Echoes the caller's own input search term back."
    },
    "is_exact_match": {
      "type": "boolean"
    },
    "fiscal_year_end": {
      "type": "string",
      "description": "MMDD, e.g. '0926' for a fiscal year ending September 26."
    },
    "sic_description": {
      "type": "string",
      "description": "Human-readable label for `sic`."
    },
    "match_confidence": {
      "type": "string",
      "description": "'exact' on the one real call observed (exact company-name match)."
    },
    "resolution_method": {
      "type": "string",
      "description": "Which resolution step matched, e.g. 'title' for the SEC title map."
    }
  },
  "description": "The company record. On an unresolvable/not-found lookup, only `error_code` and `error_message` are present instead of the company fields below.",
  "additionalProperties": true
}