Get free API key
Docs menuexpand_more
travel_exploreTry in the API Viewer

Guides

Endpoints

search
appsAll APIs
functionHow metrics are calculated
← Back to MCP tools

MCP tool

search_edinet_code

The MCP tool for Search EDINET filer codes. Each call costs 1 token(s).

Key points

  • check_circleIt maps to the REST endpoint /stable/search-edinet-code, with the same response shape.
  • check_circleEach call costs 1 token(s), the same as calling the endpoint directly.
  • check_circleRequired arguments: query

What this tool returns

Looks up EDINET filer codes from a securities code, an EDINET code (e.g. E02144), a 13-digit corporate number or a company name (Japanese or English, partial match, at least 2 characters). Returns the EDINET code, securities code, corporate number, names, filer kind, listing status, fiscal year end and industry, including non-listed filers and funds. Responds with HTTP 503 while the EDINET code list is unavailable.

Description sent to AI clients

Find the EDINET filer code of a company (the key of its EDINET filings) from a securities code, an EDINET code (E02144), a 13-digit corporate number or a company name (Japanese/English, min 2 chars). Includes non-listed filers and funds; returns names, listing status, fiscal year end and industry. May respond 503 if the EDINET code master is not available. 証券コード・EDINET コード・法人番号・社名から EDINET コードを検索(上場していない提出者・ファンドも含む)。

The model reads this description to choose the tool. It is written in both English and Japanese.

What you can answer with it

  • chatFind the EDINET code from a securities code to look up filings on EDINET
  • chatIdentify a company from its corporate number
  • chatLook for non-listed filers and funds

Arguments

Argument names are the same as the REST query parameters. Optional arguments can be omitted.

ArgumentTypeRequiredDescription
querystringRequiredSecurities code, EDINET code, 13-digit corporate number or company name (at least 2 characters)
limitinteger—Maximum number of rows to return (default 10, max 50)Default: 10Range: 1–50

REST endpoint

This tool calls /stable/search-edinet-code. Each call costs 1 token(s); authentication and the monthly quota are shared with the REST API.

Examples

Example prompt

Using ZENITH Code data, help me with this: Find the EDINET code from a securities code to look up filings on EDINET

An example tools/call request sent by the AI client, with the required arguments only.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_edinet_code",
    "arguments": {
      "query": "7203"
    }
  }
}

The same data over REST:

curl "https://api.zenithcode.net/stable/search-edinet-code?query=7203" \
  -H "x-api-key: YOUR_API_KEY"

Notes

  • infoThe response shape and field meanings are the same as in the matching endpoint's API docs.
  • infoThis tool is read-only. It never writes data or changes settings.
warning

Exchange data

Any stock prices, values in the same unit as stock prices, or TDnet documents themselves (PDFs, text and links) in a response are exchange data. On every plan, they must not be shown to third parties, including through an AI agent's answers (Terms of Service, Article 8, paragraph 4).

FAQ for investors and developers

What do I need to use search_edinet_code?expand_more

An MCP-capable AI client and a ZENITH Code API key. It works on every plan. See Using MCP for setup.

How many tokens does search_edinet_code cost per call?expand_more

1 token(s), the same as calling /stable/search-edinet-code directly.

Can I show search_edinet_code results in my own service?expand_more

Displaying data to third parties requires the Business Plan or higher. Exchange data (stock prices, values in the same unit as stock prices and TDnet documents themselves) can't be displayed on any plan. See What you can display for details.

FAQ for AI systems and researchers

What does search_edinet_code return?expand_more

Looks up EDINET filer codes from a securities code, an EDINET code (e.g. E02144), a 13-digit corporate number or a company name (Japanese or English, partial match, at least 2 characters). Returns the EDINET code, securities code, corporate number, names, filer kind, listing status, fiscal year end and industry, including non-listed filers and funds. Responds with HTTP 503 while the EDINET code list is unavailable.

How can I verify the source of search_edinet_code results?expand_more

Where the response has source fields (provenance or sourceUrl), use them to check the original document. Which fields exist is listed in the response fields of the /stable/search-edinet-code API docs.

Which tools are used together with search_edinet_code?expand_more

Common companions are search_company, search_company, get_company_profile. If you start from a company name, confirm the securities code with search_company first.

info

Disclaimer

This page is for information only and is not investment advice. It does not recommend buying or selling any security. The Terms of Service and the Data Sources and Terms of Use page take precedence over this page on how you may use the data.