Instrument Reference Data by ISIN (ESMA FIRDS)
esmafirds/instrument-by-isin
Every ESMA FIRDS record for one ISIN, one per trading venue: name, CFI code, issuer LEI, status, validity and trading dates, plus bond terms (nominal, coupon, maturity, seniority, floating-rate index) or derivative terms (expiry, option type, strike, underlying) when the instrument has them. An unknown ISIN returns an empty list. Data from the ESMA Financial Instruments Reference Data System (FIRDS), https://registers.esma.europa.eu, which may be obtained free of charge through the ESMA Registers; modified by Eden Engine (fields renamed, typed and reduced). ESMA does not endorse this product.
activeper callv1
Price
$0.0026 per call
You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $0.50.
Data source
ESMA FIRDS (Financial Instruments Reference Data System)
Instrument reference data from the Financial Instruments Reference Data System (FIRDS) of the European Securities and Markets Authority (ESMA), https://registers.esma.europa.eu. This information may be obtained free of charge through the ESMA Registers. Modified by Eden Engine (fields renamed, typed and reduced; one record per trading venue). ESMA does not endorse this product or Eden Engine.
Use it
Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.
Connect once and your AI can find and run this tool, and any other it needs.
agent
// 1. search: find the tool
omnial_search({ query: "what you need" })
// 2. inspect: price and input schema
omnial_inspect({ tool: "esmafirds/instrument-by-isin" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "esmafirds/instrument-by-isin" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "esmafirds/instrument-by-isin", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "esmafirds/instrument-by-isin", input: { /* ... */ } })
// 5. settle: the call is charged when it finishes, nothing to doNot connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.
Pricing
Every charge this tool can incur.
| Charge | Price |
|---|---|
Per call | $0.0026 |
- Updated
- Oct 27, 2026
Input and output schemas
Input schema
input_schema.json
{
"type": "object",
"required": [
"isin"
],
"properties": {
"isin": {
"type": "string",
"pattern": "^[A-Z]{2}[A-Z0-9]{9}[0-9]$",
"maxLength": 12,
"minLength": 12,
"description": "ISIN, 12 characters, upper case: a two-letter country code, nine letters or digits, a check digit. For example DE0007164600."
}
},
"additionalProperties": false
}Output schema
output_schema.json
{
"type": "object",
"required": [
"total_records",
"truncated",
"records"
],
"properties": {
"records": {
"type": "array",
"items": {
"type": "object",
"required": [
"isin",
"venue_mic",
"full_name",
"status",
"debt",
"derivative"
],
"properties": {
"debt": {
"type": [
"object",
"null"
],
"required": [],
"properties": {
"seniority": {
"type": [
"string",
"null"
],
"description": "Seniority code as ESMA publishes it, for example SNDB (senior)."
},
"floating_rate": {
"type": [
"object",
"null"
],
"required": [],
"properties": {
"term": {
"type": [
"object",
"null"
],
"required": [],
"properties": {
"unit": {
"type": [
"string",
"null"
],
"description": "ESMA unit code: DAYS, WEEK, MNTH or YEAR."
},
"value": {
"type": [
"number",
"null"
],
"description": "Number of units."
}
},
"description": "Tenor of the reference index.",
"additionalProperties": true
},
"index_isin": {
"type": [
"string",
"null"
],
"description": "ISIN of the reference index."
},
"index_name": {
"type": [
"string",
"null"
],
"description": "Name of the reference index."
},
"spread_basis_points": {
"type": [
"number",
"null"
],
"description": "Spread over the index, in basis points."
}
},
"description": "Floating-rate terms; null for a fixed-rate or zero-coupon instrument.",
"additionalProperties": true
},
"maturity_date": {
"type": [
"string",
"null"
],
"description": "Maturity date, ISO 8601 UTC."
},
"nominal_currency": {
"type": [
"string",
"null"
],
"description": "Currency of the nominal amounts (ISO 4217)."
},
"fixed_rate_percent": {
"type": [
"number",
"null"
],
"description": "Fixed coupon, percent per year (1.75 means 1.75 percent)."
},
"total_nominal_amount": {
"type": [
"number",
"null"
],
"description": "Total issued nominal amount, in nominal_currency."
},
"nominal_value_per_unit": {
"type": [
"number",
"null"
],
"description": "Nominal value of one unit, in nominal_currency."
}
},
"description": "Debt attributes; null when the instrument is not a debt instrument.",
"additionalProperties": true
},
"isin": {
"type": "string",
"description": "ISIN of the instrument."
},
"status": {
"type": [
"string",
"null"
],
"description": "ESMA record status code, for example NEWS, MODF, UNCH or TERM."
},
"cfi_code": {
"type": [
"string",
"null"
],
"description": "Classification of Financial Instruments code (ISO 10962), six letters."
},
"full_name": {
"type": [
"string",
"null"
],
"description": "Full instrument name, as reported by the venue."
},
"venue_mic": {
"type": [
"string",
"null"
],
"description": "Market identifier code (ISO 10383) of the trading venue this record is for."
},
"derivative": {
"type": [
"object",
"null"
],
"required": [],
"properties": {
"strike": {
"type": [
"object",
"null"
],
"required": [],
"properties": {
"amount": {
"type": [
"number",
"null"
],
"description": "Strike as a monetary amount, in currency."
},
"currency": {
"type": [
"string",
"null"
],
"description": "Currency of the strike amount (ISO 4217)."
},
"percentage": {
"type": [
"number",
"null"
],
"description": "Strike expressed as a percentage."
}
},
"description": "Strike price of an option or warrant.",
"additionalProperties": true
},
"commodity": {
"type": [
"object",
"null"
],
"required": [],
"properties": {
"sub_product": {
"type": [
"string",
"null"
],
"description": "Sub product code."
},
"base_product": {
"type": [
"string",
"null"
],
"description": "Base product code."
},
"final_price_type": {
"type": [
"string",
"null"
],
"description": "Final price type code."
},
"transaction_type": {
"type": [
"string",
"null"
],
"description": "Transaction type code."
},
"further_sub_product": {
"type": [
"string",
"null"
],
"description": "Further sub product code."
}
},
"description": "Commodity attributes, for a commodity derivative.",
"additionalProperties": true
},
"expiry_date": {
"type": [
"string",
"null"
],
"description": "Expiry date, ISO 8601 UTC."
},
"option_type": {
"type": [
"string",
"null"
],
"description": "Option type code as ESMA publishes it, for example CALL or PUTO (put)."
},
"delivery_type": {
"type": [
"string",
"null"
],
"description": "Settlement type code as ESMA publishes it: PHYS, CASH or OPTL."
},
"interest_rate": {
"type": [
"object",
"null"
],
"required": [],
"properties": {
"reference_rate_code": {
"type": [
"string",
"null"
],
"description": "Reference rate code."
},
"reference_rate_name": {
"type": [
"string",
"null"
],
"description": "Reference rate name."
},
"reference_rate_term": {
"type": [
"object",
"null"
],
"required": [],
"properties": {
"unit": {
"type": [
"string",
"null"
],
"description": "ESMA unit code: DAYS, WEEK, MNTH or YEAR."
},
"value": {
"type": [
"number",
"null"
],
"description": "Number of units."
}
},
"description": "Tenor of the reference rate.",
"additionalProperties": true
}
},
"description": "Interest-rate attributes, for an interest-rate derivative.",
"additionalProperties": true
},
"underlying_isin": {
"type": [
"string",
"null"
],
"description": "ISIN of the underlying instrument."
},
"foreign_exchange": {
"type": [
"object",
"null"
],
"required": [],
"properties": {
"fx_type": {
"type": [
"string",
"null"
],
"description": "FX type code."
},
"second_notional_currency": {
"type": [
"string",
"null"
],
"description": "Second notional currency (ISO 4217)."
}
},
"description": "Foreign-exchange attributes, for an FX derivative.",
"additionalProperties": true
},
"price_multiplier": {
"type": [
"number",
"null"
],
"description": "Number of units of the underlying one contract covers."
},
"underlying_index": {
"type": [
"object",
"null"
],
"required": [],
"properties": {
"code": {
"type": [
"string",
"null"
],
"description": "Code of the index."
},
"isin": {
"type": [
"string",
"null"
],
"description": "ISIN of the index."
},
"name": {
"type": [
"string",
"null"
],
"description": "Name of the index."
},
"term": {
"type": [
"object",
"null"
],
"required": [],
"properties": {
"unit": {
"type": [
"string",
"null"
],
"description": "ESMA unit code: DAYS, WEEK, MNTH or YEAR."
},
"value": {
"type": [
"number",
"null"
],
"description": "Number of units."
}
},
"description": "Tenor of the index.",
"additionalProperties": true
}
},
"description": "Underlying index, when the underlying is an index.",
"additionalProperties": true
},
"option_exercise_style": {
"type": [
"string",
"null"
],
"description": "Exercise style code as ESMA publishes it, for example EURO, AMER or BERM."
}
},
"description": "Derivative attributes; null when the instrument is not a derivative.",
"additionalProperties": true
},
"issuer_lei": {
"type": [
"string",
"null"
],
"description": "Legal entity identifier of the issuer or the trading-venue operator that reported it."
},
"short_name": {
"type": [
"string",
"null"
],
"description": "Short instrument name (ISO 18774 FISN)."
},
"valid_from": {
"type": [
"string",
"null"
],
"description": "Start of this record's validity, ISO 8601 UTC."
},
"trading_end": {
"type": [
"string",
"null"
],
"description": "Last date and time of trading on this venue, ISO 8601 UTC; null when open-ended."
},
"published_to": {
"type": [
"string",
"null"
],
"description": "When ESMA stopped publishing this record, ISO 8601 UTC; null while it is current."
},
"status_label": {
"type": [
"string",
"null"
],
"description": "The status code in words: New, Modified, Unchanged, Terminated."
},
"trading_start": {
"type": [
"string",
"null"
],
"description": "First date and time of trading on this venue, ISO 8601 UTC."
},
"published_from": {
"type": [
"string",
"null"
],
"description": "When ESMA began publishing this record, ISO 8601 UTC."
},
"notional_currency": {
"type": [
"string",
"null"
],
"description": "Currency of the notional amount (ISO 4217)."
},
"commodity_derivative": {
"type": [
"boolean",
"null"
],
"description": "True for a commodity derivative."
},
"admission_approved_at": {
"type": [
"string",
"null"
],
"description": "Date the issuer approved admission to trading, ISO 8601 UTC."
},
"admission_requested_at": {
"type": [
"string",
"null"
],
"description": "Date admission to trading was requested, ISO 8601 UTC."
},
"issuer_requested_admission": {
"type": [
"boolean",
"null"
],
"description": "True when the issuer requested admission to trading."
}
},
"description": "One FIRDS record: an instrument as listed on one trading venue.",
"additionalProperties": true
},
"description": "Records, ordered by venue_mic."
},
"truncated": {
"type": "boolean",
"description": "True when ESMA holds more than the 200 records returned."
},
"total_records": {
"type": "integer",
"description": "Number of venue records ESMA holds for the ISIN."
}
},
"description": "The FIRDS records of the ISIN.",
"additionalProperties": true
}