# ESMA FIRDS MiFIR Instrument Reference Data Lookup

> ESMA FIRDS MiFIR Instrument Reference Data Lookup is a paid API for AI agents from x402-datashop-production.up.railway.app, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Returns consolidated MiFIR reference data for a single ISIN from the ESMA FIRDS official register, including instrument names, CFI code, issuer LEI, currency, competent authority, and trading venue MICs.

## Facts

- Endpoint: GET https://x402-datashop-production.up.railway.app/v1/eu/instrument
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/esma-firds-mifir-instrument-reference-data-lookup-4a47e52d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3Szh3yPxHh2syed31kSbz

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 esma-firds-mifir-instrument-reference-data-lookup-4a47e52d
```

Example prompt: Can you pull the official MiFIR reference data for ISIN FR0000120271 — I need the full instrument name, CFI code, issuer LEI, and the list of trading venue MICs from the ESMA FIRDS register.

## When to prefer this

Use this endpoint when you need authoritative, regulation-grade MiFIR reference data for a European financial instrument identified by ISIN, particularly when you need CFI codes, issuer LEIs, trading venue MICs, or competent authority information sourced directly from the ESMA FIRDS register. Prefer this over general financial data APIs when regulatory compliance or official source traceability is required.

## Known failure modes

- Missing or invalid ISIN parameter returns an error (ISIN is required)
- ISIN not found in ESMA FIRDS returns a 404 or empty result
- Non-European ISINs may not be present in the FIRDS register
- Malformed ISIN (not 12 characters) returns a validation error
- Temporary unavailability of ESMA FIRDS upstream data may cause errors
- Payment failure (insufficient USDC balance) blocks the request

## 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

A JSON object containing the full and short instrument name, CFI code, issuer LEI, notional currency, relevant competent authority country code, the primary relevant market MIC, and a deduplicated list of trading venue MICs where the instrument is admitted. Data is sourced from ESMA FIRDS and cached for 24 hours.

## 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"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/esma-firds-mifir-instrument-reference-data-lookup-4a47e52d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-datashop-production.up.railway.app](https://www.zero.xyz/host/x402-datashop-production.up.railway.app/llms.txt)