# EU Instrument ISIN Lookup (ESMA FIRDS)

> EU Instrument ISIN Lookup (ESMA FIRDS) is a paid API for AI agents from data.greeneris.io, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Looks up a financial instrument by ISIN from the ESMA FIRDS register, returning MiFIR reference data including CFI code, issuer LEI, trading venues, and regulatory metadata.

## Facts

- Endpoint: GET https://data.greeneris.io/v1/eu/instrument
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/eu-instrument-isin-lookup-esma-firds-54546c85
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_aBtmpo2c0DYwNSx5ySrA0

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 eu-instrument-isin-lookup-esma-firds-54546c85
```

Example prompt: Can you look up the ISIN FR0000120271 and tell me the official instrument name, issuer LEI, which trading venues it's listed on, and its CFI code from the ESMA FIRDS register?

## When to prefer this

Use this endpoint when you need authoritative EU regulatory reference data for a financial instrument identified by ISIN — particularly MiFIR-compliant data including issuer LEI, CFI classification, and trading venue information. Prefer this over generic financial data APIs when regulatory accuracy, official EU source attribution (ESMA FIRDS), or LEI/MIC-level detail is required. Ideal for compliance, KYC, trade reporting, or instrument verification workflows involving European securities.

## Known failure modes

- Invalid or malformed ISIN (not 12 characters or wrong format) returns a 400 error
- ISIN not found in ESMA FIRDS register returns an empty or 404 response
- HTTP 402 returned if payment not yet made — must pay 0.005 USDC via x402 on Base and retry
- Non-EU/EEA instruments may not be present in FIRDS
- Temporary ESMA data feed unavailability may cause 503 errors

## How this service works

Consolidated MiFIR reference data for one ISIN, from the official ESMA FIRDS register (updated daily). Query: ?isin=FR0000120271 (required). Returns full and short instrument name, CFI code, issuer LEI, notional currency, relevant competent authority country, relevant market MIC and the deduplicated list of trading-venue MICs where the instrument is admitted. Cached 24h.

## Output

Returns a JSON object with the instrument's full name, short name, CFI code, issuer LEI, notional currency, trading start date, list of trading venue MIC codes, relevant market MIC, competent authority country, and whether it's a commodity derivative — all sourced from the ESMA FIRDS register under MiFIR Article 27.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "isin"
     ],
     "properties": {
      "isin": {
       "type": "string",
       "description": "12-character ISIN, e.g. FR0000120271"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "isin": "FR0000120271",
  "source": "ESMA FIRDS register (registers.esma.europa.eu), MiFIR Art. 27 reference data",
  "cfi_code": "ESVUFN",
  "full_name": "TotalEnergies SE",
  "issuer_lei": "529900S21EQ1BO4ESM68",
  "short_name": "TOTALENERGIES S/SH VTG FPD",
  "venue_count": 3,
  "notional_currency": "EUR",
  "trading_start_date": "2021-01-07T09:05:21Z",
  "trading_venues_mic": [
   "AQEA",
   "TPIR",
   "XPAR"
  ],
  "relevant_market_mic": "XPAR",
  "commodity_derivative": "No",
  "competent_authority_country": "FR"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/eu-instrument-isin-lookup-esma-firds-54546c85/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from data.greeneris.io](https://www.zero.xyz/host/data.greeneris.io/llms.txt)