FIRDS Published File List (ESMA)

esmafirds/list-files

Lists the files ESMA has published for the FIRDS instrument reference data, newest first: file name, type (DLTINS delta, FULINS full, FULCAN full cancellation), publication date, download link and checksum. Give at least one filter: file type or a publication date bound. Returns the links only; the files themselves are not fetched. 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 (file listing fields renamed and reduced). 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.

Install it Create an account

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "esmafirds/list-files" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "esmafirds/list-files" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "esmafirds/list-files", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "esmafirds/list-files", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not 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",
  "anyOf": [
    {
      "required": [
        "file_type"
      ]
    },
    {
      "required": [
        "published_from"
      ]
    },
    {
      "required": [
        "published_to"
      ]
    }
  ],
  "properties": {
    "rows": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "How many files to return, 1 to 100. Defaults to 20."
    },
    "start": {
      "type": "integer",
      "default": 0,
      "maximum": 100000,
      "minimum": 0,
      "description": "Offset of the first file to return, for paging. Defaults to 0."
    },
    "file_type": {
      "enum": [
        "DLTINS",
        "FULINS",
        "FULCAN"
      ],
      "type": "string",
      "description": "File type: DLTINS (delta of changes), FULINS (full instrument file) or FULCAN (full cancellations). Leave out for all three."
    },
    "published_to": {
      "type": "string",
      "format": "date",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Latest publication date, YYYY-MM-DD, inclusive. Leave out for no upper bound."
    },
    "published_from": {
      "type": "string",
      "format": "date",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Earliest publication date, YYYY-MM-DD, inclusive. Leave out for no lower bound."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "required": [
    "total_files",
    "start",
    "files"
  ],
  "properties": {
    "files": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "file_name",
          "file_type",
          "publication_date",
          "download_link",
          "checksum"
        ],
        "properties": {
          "checksum": {
            "type": [
              "string",
              "null"
            ],
            "description": "MD5 checksum ESMA publishes for the file; null when ESMA lists none."
          },
          "file_name": {
            "type": "string",
            "description": "File name."
          },
          "file_type": {
            "type": "string",
            "description": "DLTINS, FULINS or FULCAN."
          },
          "download_link": {
            "type": [
              "string",
              "null"
            ],
            "description": "URL of the zip file on firds.esma.europa.eu."
          },
          "publication_date": {
            "type": "string",
            "format": "date",
            "description": "Publication date, YYYY-MM-DD."
          }
        },
        "description": "A published file.",
        "additionalProperties": true
      },
      "description": "Files, by publication date descending then name."
    },
    "start": {
      "type": "integer",
      "description": "Offset of the first file on this page."
    },
    "total_files": {
      "type": "integer",
      "description": "Files matching the filters."
    }
  },
  "description": "A page of published FIRDS files, newest first.",
  "additionalProperties": true
}