{"uid":"cap_3Szh3yPxHh2syed31kSbz","slug":"esma-firds-mifir-instrument-reference-data-lookup-4a47e52d","name":"ESMA FIRDS MiFIR Instrument Reference Data Lookup","description":"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.","url":"https://x402-datashop-production.up.railway.app/v1/eu/instrument","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2XNWGpgZUo6z9ZUH5qlCv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Compliance check for cross-border fund holdings","prompt":"I need to verify the official details for each ISIN in our portfolio — pull the issuer LEI, CFI codes, and competent authority country for all our European positions from ESMA FIRDS so I can confirm we're compliant with MiFIR reporting."},{"title":"Trading venue routing decision support","prompt":"Can you look up which trading venues each of our bonds is admitted to? I need the full MIC list from the official ESMA register for ISINs in our execution algorithm so we route orders correctly."},{"title":"Regulatory audit trail documentation","prompt":"We're preparing for a regulatory audit and need to document the authoritative reference data for all our French and German equity holdings. Pull the official instrument names, LEIs, and notional currencies from ESMA FIRDS for the ISINs I'll provide."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:42:40.609Z","isFirstParty":false}