{"uid":"cap_AwsH8kw3Gx9PMXYt_pQqI","slug":"x402-entity-resolver-5c76d4ed","name":"x402 Entity Resolver","description":"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.","url":"https://x402-entity-resolver-production.up.railway.app/resolve?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}}}},"responseSchema":{"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"}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"q":"Apple"}}},"response":{"query":"Apple","candidates":[{"ids":{"cik":"0000320193","lei":"HWUPKR0MPOU8FGXBT394","ticker":"AAPL","wikidata":"Q312"},"kind":"company","name":"Apple Inc.","sources":["sec","gleif","wikidata"],"confidence":0.95},{"ids":{"ticker":"APPLE","coingecko":"apple-2"},"kind":"crypto_asset","name":"Apple","sources":["coingecko"],"confidence":0.85,"description":"market cap rank 5072"},{"ids":{"cik":"0001418121","ticker":"APLE"},"kind":"company","name":"Apple Hospitality REIT, Inc.","sources":["sec"],"confidence":0.8},{"ids":{"cik":"0001134982","ticker":"AAPI"},"kind":"company","name":"Apple iSports Group, Inc.","sources":["sec"],"confidence":0.8},{"ids":{"ticker":"AAPLON","coingecko":"apple-ondo-tokenized-stock"},"kind":"crypto_asset","name":"Apple (Ondo Tokenized Stock)","sources":["coingecko"],"confidence":0.75,"description":"market cap rank 977"},{"ids":{"wikidata":"Q89"},"kind":"entity","name":"apple","sources":["wikidata"],"confidence":0.7,"description":"edible fruit of the apple tree"},{"ids":{"ticker":"AAPLX","coingecko":"apple-xstock"},"kind":"crypto_asset","name":"Apple xStock","sources":["coingecko"],"confidence":0.65,"description":"market cap rank 1368"},{"ids":{"ticker":"PAPPLE","coingecko":"pineapple"},"kind":"crypto_asset","name":"Pineapple","sources":["coingecko"],"confidence":0.55,"description":"market cap rank 4301"}],"resolvedAt":"2026-06-07T04:30:19.590Z"}},"exampleRequest":{"q":"Apple"},"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_rQzxr3aMFmiZjTHADsf8Z","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves ambiguous company or crypto entity names/tickers to verified, cross-registry identifiers (SEC CIK, GLEIF LEI, Wikidata QID, CoinGecko slug) ranked by confidence","exampleAgentPrompt":"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?","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T00:35:58.251Z","isFirstParty":false,"canonicalSlug":"x402-entity-resolver-5c76d4ed"}