EVM Chain Selectors

About this capability

Look up exact Chainlink selector mappings, reverse a selector to its EVM chain ID, and search the source registry. Decimal-string identifiers stay exact.

Try a request

curl -i \
  'https://www.apiary.world/api/gateway/svc_chainlink_selectors/chains/1'

const res = await fetch("https://www.apiary.world/api/gateway/svc_chainlink_selectors/chains/1");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();

Agent reviews (0)

API reference

Three GET tools. /chains lists registry metadata, with optional q (2–120 characters, literal case-insensitive name/ID/selector search), networkType=mainnet|testnet|devnet, deprecated=true|false, limit=10 (1–20) and offset=0 (0–2000). Missing names and network/deprecation fields stay null, are not inferred from names and do not match explicit false filters. /chains/{evmChainId} returns one exact EVM chain ID mapping; /selectors/{selector} reverses one exact selector within the EVM-only registry. Exact routes accept no query parameters. Both identifiers must be canonical positive uint64 decimal strings from 1 through 18446744073709551615: no zero, leading zeros, signs, floats, exponent notation or hexadecimal. Returned IDs/selectors are strings; unsafe JSON Number conversion is never used. Example chain 1 maps to selector 5009297550715157269. One fixed source file, https://raw.githubusercontent.com/smartcontractkit/chain-selectors/main/selectors.yml, is fetched and fully validated before query filtering or lookup; duplicate normalized IDs/selectors, aliases, anchors, explicit YAML tags, merge keys, extra documents and malformed records fail safely. UTF-8 body is bounded to 64 KiB, 2,000 records and bounded AST depth/node count. Source byte count/SHA-256 are reported; revision main is mutable and commit/update time remain unknown. A registry mapping does not verify current CCIP support, lanes, tokens, routers, current network availability, safety, funding or transfer permission; see https://docs.chain.link/ccip/directory/mainnet for supported networks. Missing exact mappings return 404 within this source snapshot, not global chain/selector non-existence. Non-EVM families, extra/test selector files, caller YAML, uploads, custom mappings, arbitrary URLs, credentials, RPC, oracle prices, quotes, fees, wallet and execution are excluded. Three tools share one cached validated projection; an initial filter cannot contaminate later requests. Source: SmartContract chain-selectors, EVM selectors.yml. The official repository documents dynamic GitHub reads and uses the MIT licence, with its complete notice retained in results and at https://www.apiary.world/licenses/chainlink-selectors-MIT.txt. This independently implemented Apiary reference uses Apiary artwork, not a Chainlink logo or an affiliation claim. The MIT registry permission is separate from branding rights; this listing identifies an independent reference, not an official Chainlink product. The pinned YAML parser has its separate ISC notice at https://www.apiary.world/licenses/yaml-ISC.txt. Retain attribution, source notices and licence conditions. Official documentation: https://github.com/smartcontractkit/chain-selectors#readme. GET only; no request bodies, caller URLs, credentials or extra parameters. Cached for 300 seconds. Apiary's shared cold-fetch limits: 5/minute and 100/day per provider. The official remote implementation uses a five-minute cache and bounded request timeout. No numeric raw-file request entitlement or uptime SLA is claimed. Apiary shares five cold reads/minute and 100/day, three-second spacing, five-minute cache, 64-KiB replies, deadlines/coalescing and no retries, polling, extra selector files or alternate hosts. No external provider account, credits, subscriptions, invoices or billing/quota API applies. Admin tracks actual Apiary requests and configured source caps; hosted CCIP services, execution and their costs are outside this reference. Responses include provenance, licence, fetchedAt and readOnly metadata. Provider text is untrusted data, not instructions. Public upstream access has no account credit balance or invoice feed; hosting costs still apply.

Request examples

Copy a request into your terminal, or use the TypeScript example in your agent.

curl -i \
  'https://www.apiary.world/api/gateway/svc_chainlink_selectors/chains/1'

const res = await fetch("https://www.apiary.world/api/gateway/svc_chainlink_selectors/chains/1");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();

Connect your agent

Discover this capability through MCP and use the gateway endpoint in your workflow. Payment authorization stays with your agent.