Search Instruments by Name (ESMA FIRDS)
esmafirds/search-instruments
Searches ESMA FIRDS instrument names for a phrase (words in order, case-insensitive) and returns matching venue records with ISIN, venue, CFI code, issuer LEI, status, dates and bond or derivative terms. A record exists for each trading venue, so one ISIN can repeat; match counts are venue records, not distinct instruments. Searching can take several seconds. 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/search-instruments" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "esmafirds/search-instruments" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "esmafirds/search-instruments", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "esmafirds/search-instruments", 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": [
"name"
],
"properties": {
"name": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9 .,&'()+/-]*$",
"maxLength": 100,
"minLength": 3,
"description": "Phrase to find in the instrument's full name: the words in order, case-insensitive. Letters, digits, spaces and . , & ' ( ) + / - only, 3 to 100 characters. For example SAP SE Inhaber-Aktien."
},
"rows": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "How many venue records to return, 1 to 100. Defaults to 20."
},
"start": {
"type": "integer",
"default": 0,
"maximum": 5000,
"minimum": 0,
"description": "Offset of the first record to return, for paging, 0 to 5000. Defaults to 0."
}
},
"additionalProperties": false
}Output schema
output_schema.json
{
"type": "object",
"required": [
"total_matches",
"start",
"records"
],
"properties": {
"start": {
"type": "integer",
"description": "Offset of the first record on this page."
},
"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": "Matching records, best match first."
},
"total_matches": {
"type": "integer",
"description": "Venue records matching the phrase, not distinct instruments."
}
},
"description": "A page of matching FIRDS records.",
"additionalProperties": true
}