# 2s FIGI Lookup — Financial Instrument Identifier Resolver

> 2s FIGI Lookup — Financial Instrument Identifier Resolver is a paid API for AI agents from 2s.io, paid per call via x402, $0.00144/call, status unknown (last checked 2026-10-10).

Resolves financial instrument identifiers (ISIN, CUSIP, TICKER, SEDOL, FIGI, etc.) to OpenFIGI records including exchange listings, security type, and market sector

## Facts

- Endpoint: GET https://2s.io/api/finance/figi?utm_source=zero.xyz
- Price: $0.00144/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-figi-lookup-financial-instrument-identifier-resolver-9cd868a1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_aYAMYza0_pRJe8TbJrgNp

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 2s-figi-lookup-financial-instrument-identifier-resolver-9cd868a1
```

Example prompt: Look up the OpenFIGI records for Apple Inc using its ISIN US0378331005 on the US exchange, and show me the FIGI codes, security type, and market sector.

## When to prefer this

Use this endpoint when you need to resolve or cross-reference financial instrument identifiers across different symbology standards (ISIN, CUSIP, SEDOL, TICKER, etc.) to obtain canonical FIGI codes and exchange-level security metadata. Ideal for normalizing security identifiers across data sources, enriching trade data, or confirming which exchanges a security is listed on. Prefer over manual OpenFIGI API integration when you need pay-per-call access without signup or API keys.

## Known failure modes

- Invalid or unrecognized identifier value returns empty items array or ok:false
- Unsupported idType string causes query failure
- Identifier exists but no matching exchange/currency filter yields zero results
- Payment not received via x402 returns 402 Payment Required
- Rate limits or upstream OpenFIGI unavailability cause timeout or error

## How this service works

Map a security identifier to its FIGI (Financial Instrument Global Identifier) and metadata via OpenFIGI. Give an idType (ISIN, CUSIP, SEDOL, TICKER, FIGI, COMMON, WKN, CINS — or a raw OpenFIGI ID_* type) and idValue, optionally narrowed by exchCode (e.g. US, LN) or currency. Returns each matching listing with its FIGI, composite FIGI (per-country grouping), share-class FIGI (cross-country grouping), name, ticker, exchange code, security type, market sector, and description. Free, open symbology (Bloomberg OpenFIGI; FIGI is an open OMG/ANNA standard). The canonical "what is this security and what are its identifiers across exchanges" lookup — for trading, reference-data, and portfolio agents.

## Output

Returns an array of matching financial instrument records from OpenFIGI, each containing the FIGI code, composite FIGI, share class FIGI, ticker, exchange code, market sector, security type, and description. Also includes total match count and source attribution (OpenFIGI/Bloomberg).

## 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",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "required": [
      "idType",
      "idValue"
     ],
     "properties": {
      "limit": {
       "type": "integer",
       "description": "Max listings (1-100, default 25)."
      },
      "idType": {
       "type": "string",
       "description": "ISIN, CUSIP, SEDOL, TICKER, FIGI, COMMON, WKN, CINS, or a raw OpenFIGI ID_* type."
      },
      "idValue": {
       "type": "string",
       "description": "The identifier value, e.g. US0378331005."
      },
      "currency": {
       "type": "string",
       "description": "Currency to narrow (e.g. USD)."
      },
      "exchCode": {
       "type": "string",
       "description": "Exchange code to narrow (e.g. US, LN)."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-figi-lookup-financial-instrument-identifier-resolver-9cd868a1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)