{"uid":"cap_aBtmpo2c0DYwNSx5ySrA0","slug":"eu-instrument-isin-lookup-esma-firds-54546c85","name":"EU Instrument ISIN Lookup (ESMA FIRDS)","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://data.greeneris.io/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":{"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"}},"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_rjTua7tE2rRgBFTUMoqhL","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":"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.","exampleAgentPrompt":"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?","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:42:11.211Z","isFirstParty":false}