# Eckari US Company Resolver

> Eckari US Company Resolver is a paid API for AI agents from api.eckari.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-10).

Resolves a company name fragment or stock ticker to SEC EDGAR identifiers (CIK, ticker, registered name, exchange) with ranked matches

## Facts

- Endpoint: GET https://api.eckari.com/v1/companies/us/resolve?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/eckari-us-company-resolver-dd817759
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1oZogDHpZ_Q6eaZSFTGT3

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability eckari-us-company-resolver-dd817759
```

Example prompt: Can you find the SEC EDGAR CIK and exchange listing for the company behind the ticker AAPL? I need to look up its EDGAR filings.

## When to prefer this

Use this endpoint when you have a company name or name fragment and need to resolve it to a canonical SEC EDGAR CIK before calling other SEC-based capabilities. It is specifically designed for name-to-identifier resolution; other Eckari company.us.* endpoints accept a ticker directly and do not perform this resolution step. Prefer this over generic web search when you need a deterministic, structured, ranked result from the official SEC listed-security index.

## Known failure modes

- Query string too short or empty — returns 400 validation error
- No matching company found — returns empty items array with total=0
- Ambiguous name fragment returns many low-confidence results — caller must inspect match_type and rank
- Rate limiting or payment failure (x402) — returns 402 Payment Required
- Ticker not listed in SEC index (e.g. OTC-only or foreign-only) — may return no results or wrong entity

## How this service works

Turn a company-name fragment or stock ticker into the SEC EDGAR identifiers. Searches the SEC listed-security index and returns ranked matches with the 10-digit CIK, ticker, registered name and listing exchange. Deterministic ranking: ticker exact, then name exact, then name prefix, then name contains. Use it for names — the other company.us.* capabilities take a ticker directly. Use when: Which SEC filer and CIK does the company name "Apple" belong to?

## Output

Returns a ranked list of matches (up to 25), each containing the 10-digit CIK, ticker symbol, registered company name, and listing exchange. Also includes pagination info (total matches, has_more, offset) and match metadata (query string, match_type indicating whether it was a ticker exact, name exact, name prefix, or name contains match). Source is SEC EDGAR near-live data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "maxLength": 200,
       "minLength": 1,
       "description": "Ticker symbol (e.g. AAPL) or company-name fragment (e.g. Apple). Matching is case-insensitive and trimmed; no fuzzy matching is applied."
      },
      "limit": {
       "type": "integer",
       "default": 10,
       "maximum": 25,
       "minimum": 1,
       "description": "Maximum number of ranked matches to return. Ranking is applied before the limit; page.total reports how many matched in full."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "page": {
    "limit": 3,
    "total": 1,
    "offset": 0,
    "has_more": false,
    "returned": 1,
    "next_offset": null
   },
   "items": [
    {
     "cik": "0000320193",
     "name": "Apple Inc.",
     "ticker": "AAPL",
     "exchange": "Nasdaq"
    }
   ],
   "query": "AAPL",
   "match_type": "ticker_exact"
  },
  "meta": {
   "source": "sec_edgar",
   "version": "2.0.0",
   "freshness": "near_live",
   "capability": "company.us.resolve"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/eckari-us-company-resolver-dd817759/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.eckari.com](https://www.zero.xyz/host/api.eckari.com/llms.txt)