# x402 Entity Resolver

> x402 Entity Resolver is a paid API for AI agents from x402-entity-resolver-production.up.railway.app, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-13).

Resolves ambiguous company or crypto entity names/tickers to verified, cross-registry identifiers (SEC CIK, GLEIF LEI, Wikidata QID, CoinGecko slug) ranked by confidence

## Facts

- Endpoint: GET https://x402-entity-resolver-production.up.railway.app/resolve?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-entity-resolver-5c76d4ed
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AwsH8kw3Gx9PMXYt_pQqI

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 x402-entity-resolver-5c76d4ed
```

Example prompt: Can you resolve 'Stripe' to its official cross-registry IDs — I need the SEC CIK, GLEIF LEI, and Wikidata QID so I can link it properly in our database?

## When to prefer this

Use this endpoint when you need authoritative, multi-registry identifiers for a company or crypto asset and cannot rely on an LLM's memory — especially when downstream systems require verified SEC CIK, LEI, or CoinGecko slugs. Prefer this over static lookup tables when freshness and source attribution matter, or when the query is ambiguous and you need ranked confidence scores.

## Known failure modes

- Ambiguous query returns multiple low-confidence candidates — caller must disambiguate
- Unknown entity returns empty candidates array
- Malformed query parameter returns 400 error
- Payment not provided or insufficient results in 402 Payment Required
- Registry sources temporarily unavailable may reduce ID coverage or confidence
- Obscure entities may only resolve to Wikidata QID with no SEC/LEI data

## How this service works

Paid x402 endpoint: resolve an ambiguous name or ticker (Apple, ETH, Stripe) into ranked entities with verified canonical IDs — SEC CIK + ticker, GLEIF LEI, Wikidata QID, CoinGecko slug. $0.005 per call, USDC on Base.

## Output

Returns a ranked list of candidate entities matching the query, each with a kind (company, crypto_asset, or entity), a name, a confidence score, a description, the sources that agreed on the match, and an ids object containing whichever of the following are applicable: SEC CIK, ticker, GLEIF LEI, Wikidata QID, CoinGecko slug, domain, chain ID, and contract address. Also includes a resolvedAt timestamp.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "q": "Apple"
  }
 }
}
```

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Ambiguous entity name or ticker to resolve, e.g. Apple, ETH, Stripe."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "query": {
       "type": "string"
      },
      "candidates": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "ids": {
          "type": "object",
          "properties": {
           "cik": {
            "type": "string"
           },
           "lei": {
            "type": "string"
           },
           "domain": {
            "type": "string"
           },
           "ticker": {
            "type": "string"
           },
           "chainId": {
            "type": "number"
           },
           "contract": {
            "type": "string"
           },
           "wikidata": {
            "type": "string"
           },
           "coingecko": {
            "type": "string"
           }
          }
         },
         "kind": {
          "enum": [
           "company",
           "crypto_asset",
           "entity"
          ],
          "type": "string"
         },
         "name": {
          "type": "string"
         },
         "sources": {
          "type": "array",
          "items": {
           "type": "string"
          }
         },
         "confidence": {
          "type": "number"
         },
         "description": {
          "type": "string"
         }
        }
       }
      },
      "resolvedAt": {
       "type": "string",
       "format": "date-time"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "apple",
  "candidates": [
   {
    "ids": {
     "cik": "0000320193",
     "lei": "HWUPKR0MPOU8FGXBT394",
     "ticker": "AAPL",
     "wikidata": "Q312"
    },
    "kind": "company",
    "name": "Apple Inc.",
    "sources": [
     "sec",
     "gleif",
     "wikidata"
    ],
    "confidence": 0.98
   }
  ],
  "resolvedAt": "2026-06-06T12:00:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-entity-resolver-5c76d4ed/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-entity-resolver-production.up.railway.app](https://www.zero.xyz/host/x402-entity-resolver-production.up.railway.app/llms.txt)