---
name: x402-entity-resolver-production.up.railway.app
description: This host provides a single-shot entity resolution service that takes an ambiguous company name, stock ticker, or crypto asset name and returns ranked candidate matches with verified canonical identifiers drawn from official registries including SEC EDGAR (CIK), GLEIF (LEI), Wikidata (QID), and CoinGecko (slug). It queries live sources rather than a static local database. It is designed for one entity lookup at a time, not bulk or streaming resolution.
host: x402-entity-resolver-production.up.railway.app
---

# x402-entity-resolver-production.up.railway.app

x402-entity-resolver-production.up.railway.app is a focused entity disambiguation service for financial and compliance contexts. It serves agents that need to pin an ambiguous name or ticker to a verified, cross-registry canonical ID before proceeding to downstream data queries. Its distinguishing characteristic is multi-registry coverage in a single call: one query can return SEC CIK, GLEIF LEI, Wikidata QID, and CoinGecko slug simultaneously, covering both traditional securities and crypto assets.

## When to use this host

Use this host when an agent has a raw company name, stock ticker, or crypto asset name and needs to obtain verified canonical IDs (SEC CIK, GLEIF LEI, Wikidata QID, CoinGecko slug) before querying financial data APIs, compliance systems, or knowledge graphs. Do not use it for bulk or batch entity resolution — it handles one query per call and is not optimized for high-volume pipelines. It is not suitable for resolving personal names, geographic locations, or non-financial entities. If the agent already has a known canonical ID, this host adds no value. For downstream financial data retrieval after resolution, a separate financial data host would be required; this host only provides the identifier mapping step.

## Capabilities

### Entity Disambiguation

Resolves an ambiguous name or ticker into ranked candidate entities, each annotated with verified canonical identifiers from official financial, legal, and knowledge-graph registries.

- **`resolve-entity-to-canonical-ids`** — Resolves an ambiguous company name or ticker into ranked candidates with verified canonical IDs (SEC CIK, GLEIF LEI, Wikidata QID, CoinGecko slug) sourced live from official registries.

## Skill reference

### `resolve-entity-to-canonical-ids`

**Entity Resolver** — Resolves an ambiguous company name or ticker into ranked candidates with verified canonical IDs (SEC CIK, GLEIF LEI, Wikidata QID, CoinGecko slug) sourced live from official registries.

*Use when:* Use when an agent needs to disambiguate a company name, stock ticker, or crypto asset name into verified canonical identifiers before querying financial data, compliance systems, or knowledge graphs.

*Not for:* Do not use for bulk entity resolution or streaming lookups; this is a single-shot query per name. Not suitable for resolving personal names or geographic entities.

**Inputs:**

- `q` (string, required) — Ambiguous entity name or ticker to resolve, e.g. Apple, ETH, Stripe.

**Returns:** Returns a resolvedAt timestamp and a candidates array ranked by confidence, each with kind, name, canonical IDs (CIK, ticker, LEI, Wikidata QID, CoinGecko slug), and source attribution.

**Example:** `GET https://x402-entity-resolver-production.up.railway.app/resolve?q=apple`

---