Skip to main content

Overview

finance_search lets the model pull structured financial and market data for public companies, ETFs, and related instruments. The model decides which fields to fetch based on your prompt. Use it when one answer needs more than one type of financial data, such as valuation, earnings, and context for the same company or list of companies.

Capabilities

Coverage

finance_search coverage depends on the symbol, exchange, asset class, geography, and source data availability.
Market data may be delayed, incomplete, or unavailable for some symbols. finance_search is for informational use only and does not provide investment, legal, tax, or financial advice.

Quickstart

Add finance_search to the tools array.

Example Prompts

  • Full company brief: “Give me a complete NVIDIA snapshot: valuation, segment revenue for the latest quarter, and management’s latest commentary on margins guidance.”
  • Compare companies in one request: “Compare Apple, Microsoft, and Alphabet on revenue growth, operating margin, and forward P/E for the latest fiscal year.”
  • Earnings + reaction context: “Summarize Tesla’s last earnings call, include actual vs consensus, and describe how the stock and analyst targets moved after publication.”

Prompt Guidance

finance_search works best when the prompt states the outcome, not the data shape.
  • Start with the business question first, then include the company or ticker.
  • Add time windows when relevant (latest quarter, fiscal year to date, last 30 days).
  • Let the tool decide which specific report fields to retrieve.
Start with the configuration that matches the shape of the finance question.

Live Market Data and Quotes

Use this for time-sensitive answers that depend on real-time prices, quotes, or the latest market figures. It is the cheapest and fastest option while maintaining strong quality for live data lookups.

Single-Company Historical Lookups

Use this for a single company’s historical figures or basic questions that benefit from both structured finance data and web context. GPT-5.5 is strong at simple web search and token-efficient for historical lookups.

Multi-Step Financial Research

Use this for cross-company comparisons, longer historical investigations, and analysis that needs several tool calls across financial statements, filings, transcripts, and web sources. Opus performs best on complex multi-step reasoning when paired with the full tool suite.

Parameters

Response Shape

When finance_search runs, the response can include finance_results output items before the final assistant message. Each finance_results item includes the requested finance categories, ticker symbols, structured content, and source URLs when available. The final usage object includes token counts, cost details, and tool_calls_details.finance_search.invocation when tool-call usage is reported.

Pricing

finance_search is billed at $5 per 1,000 invocations. Model token usage is billed separately according to Agent API token pricing.
Pricing follows the same pattern as other tool calls: pay for invocations plus model tokens. See Pricing.

Limits / Quotas

finance_search uses the same Agent API request flow as other tools. Limits depend on your account tier, request configuration, and the number of tool invocations needed to answer the prompt. See Rate Limits & Usage Tiers for tier-based request limits.

Next Steps

Web Search

Search the web for source-grounded context.

Fetch URL Content

Fetch full content from known URLs.

People Search

Search for professionals and employees.

Agent API Quickstart

Get started with the Agent API.