Available Resources & Prompts

FinanceDataAPI exposes both resources (read-only browseable data) and prompts (templated workflows) in addition to tools.

Resources

Resources are designed for discovery and browsing. The current server registers three of them.

`symbols://list`

Name: symbols_list
Mime type: application/json
What it returns: the first 50 available trading symbols plus pagination metadata
When to use it: when an agent needs a fast browseable starting point before switching to list_symbols

`symbols://{ticker}`

Name: symbol_detail
Mime type: application/json
What it returns: full metadata for one ticker, for example symbols://AAPL
When to use it: when an agent already knows the ticker and wants a direct, read-only lookup

`signals://definitions`

Name: signal_definitions
Mime type: application/json
What it returns: every registered signal definition, description, and parameter list
When to use it: before run_signals or per-signal tool calls when the agent needs to inspect the available signal catalog

Prompts

Prompts give the agent a recommended sequence of tool calls. FinanceDataAPI currently exposes three prompt templates.

`analyze_ticker`

Parameters

{
  "type": "object",
  "required": ["symbol"],
  "properties": {
    "symbol": { "type": "string" },
    "lookback_days": { "type": "integer", "default": 90 }
  }
}

This prompt walks the agent through get_symbol, get_rsi, get_macd, and two get_sma calls before it writes a concise trend summary.

`compare_strategies`

Parameters

{
  "type": "object",
  "required": ["symbols", "start_date", "end_date"],
  "properties": {
    "symbols": { "type": "string" },
    "start_date": { "type": "string", "format": "date" },
    "end_date": { "type": "string", "format": "date" }
  }
}

This prompt tells the agent to run two run_signals batches and compare the latest indicator values across multiple symbols.

`backtest_strategy`

Parameters

{
  "type": "object",
  "required": ["symbol"],
  "properties": {
    "symbol": { "type": "string" },
    "lookback_years": { "type": "integer", "default": 2 },
    "initial_capital": { "type": "number", "default": 10000.0 }
  }
}

This prompt instructs the agent to submit a standard RSI mean-reversion backtest, wait for completion, and summarize the resulting metrics.

When should an agent use which surface?

| Need | Best surface | | --- | --- | | Browse a stable read-only URI | Resource | | Discover callable actions and send structured arguments | Tool | | Kick off a proven multi-step workflow | Prompt |