# Company Facts Lookup by Ticker

> Company Facts Lookup by Ticker is a paid API for AI agents from api.firstmention.uk, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-29).

Returns SEC EDGAR company facts and sanctions check for a public company given its stock ticker symbol

## Facts

- Endpoint: GET https://api.firstmention.uk/s/company-facts/lookup?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/company-facts-lookup-by-ticker-306ef1d3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uMWJ5PQCzuk3DMkeubn4a

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 company-facts-lookup-by-ticker-306ef1d3
```

Example prompt: Can you look up the official company facts for AAPL — I need its SEC CIK number, state of incorporation, SIC description, and whether it's on any sanctions list?

## When to prefer this

Choose this endpoint when you need to combine SEC EDGAR corporate identity data with a sanctions check in a single call for a publicly traded US company identified by its stock ticker. It is ideal for compliance workflows, financial research agents, or onboarding pipelines that need authoritative company metadata (CIK, SIC, incorporation state, filing history) alongside a sanctions flag — rather than querying EDGAR and a sanctions database separately.

## Known failure modes

- Unknown or invalid ticker symbol returns resolved:false with no EDGAR data
- Delisted or OTC tickers may not resolve in EDGAR
- Payment failure via x402 returns HTTP 402 before data is delivered
- Network timeouts on EDGAR or sanctions data source result in 5xx errors
- Tickers for foreign-listed companies without SEC filings may not resolve

## How this service works

Pay-per-call HTTP APIs, paid with x402 in USDC on Base (eip155:8453): agentkit, api-change-check, basedue, basewatch, chainread, check-sanctions, chgwatch, company-facts, composite, edgar, feednews, pageaudit, solcheck, token-dd, txpreflight, walletcheck, webmd, webread, websearch, x402index. Each operation describes its service.

## Output

A JSON object containing: the queried ticker symbol, whether it resolved successfully, EDGAR data (CIK, official company name, associated tickers, SEC filing counts by form type, SIC industry description, state of incorporation), and a sanctions check result indicating whether the company matched any sanctions list.

## 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"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Free-text company name or ticker, e.g. 'Rosneft' or 'AAPL'"
      },
      "limit": {
       "type": "integer",
       "maximum": 25,
       "minimum": 1,
       "description": "Max candidates, default 5 (max 25)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "query": {
       "type": "string"
      },
      "resolved": {
       "type": "boolean"
      },
      "best_score": {
       "type": "number"
      },
      "candidates": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "cik": {
          "type": "string"
         },
         "name": {
          "type": "string"
         },
         "score": {
          "type": "number"
         },
         "ticker": {
          "type": "string"
         }
        }
       }
      },
      "candidate_count": {
       "type": "number"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "edgar": {
   "cik": "0000320193",
   "name": "Apple Inc.",
   "tickers": [
    "AAPL"
   ],
   "form_counts": [
    {
     "form": "4",
     "count": 217
    }
   ],
   "sic_description": "Electronic Computers",
   "state_of_incorporation": "CA"
  },
  "query": "AAPL",
  "resolved": true,
  "sanctions": {
   "match": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/company-facts-lookup-by-ticker-306ef1d3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.firstmention.uk](https://www.zero.xyz/host/api.firstmention.uk/llms.txt)
