# 2s FIGI Search — Financial Instrument Global Identifier Lookup

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

Searches the OpenFIGI database for financial instruments by name, ticker, or description, returning FIGI identifiers and security metadata.

## Facts

- Endpoint: GET https://2s.io/api/finance/figi-search
- Price: $0.00144/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-figi-search-financial-instrument-global-identifier-lookup-b6c49d35
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pHNVLymq5pPFrxmRxubDR

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-search-financial-instrument-global-identifier-lookup-b6c49d35
```

Example prompt: Search OpenFIGI for Apple Inc common stock on the US exchange and give me the FIGI, composite FIGI, and share class FIGI — return up to 5 results.

## When to prefer this

Use this endpoint when you need to resolve a financial instrument to its standardized FIGI identifier, or when you need to search for securities by name, ticker, or description across exchanges and asset classes. Prefer this over manual Bloomberg lookups or exchange-specific symbol tables when you need a universal, open-standard identifier that works across equities, bonds, currencies, commodities, indices, and more.

## Known failure modes

- No results found for the given query — returns empty items array with total 0
- Invalid marketSector or securityType enum value — may return empty or error response
- Pagination cursor (start) is invalid or expired — returns error or restarts from beginning
- Query string too vague returns too many irrelevant results requiring further filtering
- Payment failure via x402 — request rejected before processing

## How this service works

Free-text search for securities across global exchanges via OpenFIGI. Give a query (company name, ticker, description) and optionally narrow by exchCode (e.g. US), securityType, or marketSector (Equity, Corp, Govt, Mtge, Muni, Pfd, Comdty, Index, Curncy). Returns relevance-ranked matches with FIGI, composite/share-class FIGI, name, ticker, exchange, security type, market sector, and description, plus a `next` cursor for paging (pass it back as start). Free, open symbology (Bloomberg OpenFIGI). Distinct from finance.figi (exact identifier → FIGI): this is discovery by name/keyword.

## Output

Returns a paginated list of matching financial instruments, each with FIGI, composite FIGI, share class FIGI, ticker, exchange code, market sector, security type, and security description. Also includes total result count, pagination cursor for next page, and source/license attribution from OpenFIGI.

## 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": [
      "query"
     ],
     "properties": {
      "limit": {
       "type": "integer",
       "description": "Max results (1-100, default 20)."
      },
      "query": {
       "type": "string",
       "description": "Search text (name/ticker/description)."
      },
      "start": {
       "type": "string",
       "description": "Pagination cursor (the previous response's next)."
      },
      "exchCode": {
       "type": "string",
       "description": "Exchange code, e.g. US, LN."
      },
      "marketSector": {
       "type": "string",
       "description": "Equity, Corp, Govt, Mtge, Muni, Pfd, Comdty, Index, Curncy."
      },
      "securityType": {
       "type": "string",
       "description": "Security type filter, e.g. \"Common Stock\"."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-figi-search-financial-instrument-global-identifier-lookup-b6c49d35/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)