Let an AI agent research Japanese stocks

Tokens are the total if each tool in the row is called once. The actual tools and number of calls depend on the model.

• savingsWhen the user gives a company name, have the agent confirm the securities code with search_company first. A guessed code can return another company's data.
• savingsKeep the limit argument small so the agent fetches only the periods and rows it needs. Longer responses also use more of the model's context.
• savingslist_stocks and list_etfs cost 100 tokens per call. To filter by criteria, screen_stocks or get_rankings (10 tokens) is enough.
• savingsFor annual-report text (get_annual_report_text), have the agent narrow the section with the tag argument. Without it you get only the table of contents.
• savingsCheck the remaining tokens with get_usage (1 token). When you call the REST API directly, the X-Monthly-Quota-Remaining response header shows it too.

"provenance": {
  "source": "edinet",
  "docId": "S100XXXX",
  "announcedAt": "2026-06-24",
  "sourceUrl": "https://disclosure2.edinet-fsa.go.jp/WZEK0040.aspx?S100XXXX"
}

An example system prompt. Adapt it to your use.

Use only values fetched with the ZENITH Code tools for Japanese stock figures.
After each number, cite its source (provenance.source and docId, or sourceUrl).
Ratios are returned as decimals between 0 and 1; show them as percentages.
On HTTP 429, wait for the number of seconds in Retry-After, then retry once.
Do not include stock prices, values in the same unit as stock prices, or links to TDnet documents in answers for third parties.
Do not recommend buying or selling any security.

1. On 429 rate_limit_exceeded, wait for Retry-After

   Exceeding the per-minute limit returns HTTP 429 with error: rate_limit_exceeded. Wait for the Retry-After header (seconds) or the retryAfter field before retrying.

2. On 429 quota_exceeded, stop retrying

   Running out of monthly tokens also returns 429, but with error: quota_exceeded. It won't recover until the start of next month (UTC), so the agent should not keep retrying.

3. On 503 origin_busy, wait for Retry-After too

   When the data source is busy and no cached copy is available, you may get 503 with Retry-After. These responses don't consume tokens.

4. Never pass exchange data to third parties

   Stock prices, values in the same unit as stock prices (open, high, low, close, moving averages, period highs and lows, day-over-day and percentage changes) and TDnet documents themselves (PDFs, text and links) are exchange data. On every plan, they must not be shown to third parties through an agent's answers (Terms of Service, Article 8, paragraph 4).

5. Agents serving other people need Business or higher

   Any plan lets AI agents that you yourself use refer to the data (Article 8, paragraph 1, item 2). Providing the answers to anyone else, or letting an agent refer to the data at the request of your service's end users, requires the Business Plan or higher (paragraph 2 of the same article).

6. Don't work around limits or recommend trades

   Don't combine multiple accounts or API keys to get around usage limits (Terms of Service, Article 7). ZENITH Code data is not investment advice, so keep buy or sell recommendations out of the agent's answers too.

HTTP/1.1 429 Too Many Requests
Retry-After: 12

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit of 60 requests/minute exceeded.",
  "retryAfter": 12
}

Above: an example response when the per-minute limit is exceeded (values are illustrative).

• errorRatios are decimals between 0 and 1: 0.082 in the API is 8.2% on screen. Treating them as percentages makes the answer off by a factor of 100.
• errorQuarterly results are cumulative from the start of the fiscal year. Q3 covers nine months; subtract the previous cumulative figure to get a single quarter.
• errorA period is identified by fiscalPeriod (the year and month the row’s period ends) and period (Q1–Q3 or FY). fiscalPeriod 2026-03 with period FY is the fiscal year ended March 2026. Quarterly rows use the quarter-end month, so 2026-06 with Q1 is Q1 of the fiscal year ending March 2027. There is no fiscalYear field.
• errornull means not disclosed or not applicable, which is different from 0. Ordinary income (ordinaryIncome) is null for IFRS reporters.
• errorAmounts are integer yen, not the millions of yen used in many filings.
• errorFor a given period, earnings-summary figures come first and are replaced by the audited figures once the annual report is filed. Tell them apart with provenance.source.