Spiral gives your agent every tool with one account. Browse the tools →

Hermes · Finance

How to Use Tiingo ticker metadata in Hermes

Get an asset's full name, description, listing exchange, and the first and last dates of available Tiingo price history. Use it to identify a security and check whether its recorded history covers your research period.

Prompts to try with Tiingo ticker metadata in Hermes

Copy an example into Hermes, or ask in your own words.

Every weekday morning, use Tiingo ticker metadata for AAPL, MSFT, and NVDA. Report each asset's name and latest available price date.

Tiingo ticker metadataHermes
Try asking
  • Every Monday, use Tiingo ticker metadata for SPY, QQQ, and VTI. Show the common date range available for comparative research.

  • On the first business day of each month, use Tiingo ticker metadata for BRK-A and BRK-B. Show their returned names and listing exchanges.

  • Every Friday, use Tiingo ticker metadata for KO, PEP, and KDP. Prepare an internal briefing from their returned descriptions.

  • Every Monday, use Tiingo ticker metadata for NVDA, AMD, and INTC. Check which available histories cover January 1, 2010 through December 31, 2020.

How to set up Tiingo ticker metadata in Hermes

Pick the way that suits you. Each takes about two minutes.

Use the Spiral skill

  1. Send Hermes this message

    Your agent reads Spiral's skill and sets itself up.

    set up https://spiral.ai/SKILL.md
  2. Sign in or paste a key

    Approve Spiral in the browser, or give the agent a key from the console.

Use Spiral's MCP server

  1. Add the server and sign in

    Hermes opens your browser: sign in to Spiral and click Authorize. No API key. When Hermes asks Enable all tools? \[Y/n/select], answer Y: n cancels without saving the server, and select hides the tools you leave out.

    hermes mcp add spiral \
      --url https://api.spiral.ai/mcp \
      --auth oauth \
      --connect-timeout 300
  2. Check it

    In a chat that was already open, run /reload-mcp.

    hermes mcp list
    hermes mcp test spiral

Use the Spiral CLI

  1. Install and sign in

    Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run Tiingo ticker metadata

    One request; the result comes back by polling or a webhook.

    curl https://api.spiral.ai/v1/runs \
      -H "Authorization: Bearer $SPIRAL_API_KEY" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: $(uuidgen)" \
      -d '{
        "provider": "alexandria",
        "model": "tiingo/tickers/meta",
        "input": {
          "ticker": "<ticker>"
        }
      }'

Then paste one of the prompts above: Hermes finds Tiingo ticker metadata on Spiral, shows the price and runs it.

Tiingo ticker metadata providers and prices

Spiral runs Tiingo ticker metadata through Alexandria. Open a card for today's price, with every fee included.

AlexandriaFinance
Tiingo · Ticker metadata
tiingo/tickers/meta

What can you do with Tiingo ticker metadata in Hermes?

Produce a scheduled check of the price-history dates available for a research watchlist. Include Tiingo's returned names and exchanges so each report identifies the assets being checked.

Check a backtest's starting date

Compare the earliest available dates for SPY, QQQ, and VTI against a proposed January 2000 start. Identify which assets need a shorter research window.

Find a shared research window

Use the latest starting date and earliest ending date across selected assets to propose a common period for subsequent price analysis.

Explain securities in a watchlist

Pair symbols with their returned names, descriptions, and listing exchanges so an internal watchlist gives readers context.

Review symbol mappings

Check whether the names and exchanges returned for BRK-A and BRK-B match the securities intended in an internal research list.

Check available-history endpoints

Review the latest available price dates for AAPL, MSFT, and NVDA before starting a daily research report.

Compare business descriptions

Read the returned descriptions for KO, PEP, and KDP side by side to prepare an internal company comparison.

Questions about Tiingo ticker metadata in Hermes

Can Hermes use Tiingo ticker metadata?

Yes. Add Spiral to Hermes as an MCP server, and Hermes can find and run Tiingo ticker metadata like any built-in tool.

How much does Tiingo ticker metadata cost in Hermes?

Up to $0.17459 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Hermes plan is separate.

Do I need an Alexandria account to use Tiingo ticker metadata in Hermes?

No. Spiral runs Tiingo ticker metadata on its own Alexandria account. You sign in to Spiral once and never paste a key.

How long does it take to set up Tiingo ticker metadata in Hermes?

About two minutes: add the server and sign in, then check it.

Does Hermes wait while Tiingo ticker metadata runs?

Tiingo ticker metadata runs in the background. Hermes starts the run, checks on it and gives you the json when it's ready.

Which markets and asset types does Tiingo cover?

Tiingo lists US equities, ETFs, mutual funds, and Chinese A-shares in its end-of-day coverage. Check the requested asset's metadata for its available history.

Are the returned dates the company's founding and listing dates?

They mark the earliest and latest price data Tiingo has for the asset. Use them to check the available research window, rather than as company milestones.

When does Tiingo update the underlying daily data?

Tiingo lists 5:30 PM EST updates for equities and ETFs, and midnight EST for mutual fund NAVs. Those times describe the price data; the metadata end date reports the latest price date available.

How does Tiingo write share-class symbols?

Tiingo uses hyphens instead of periods to separate share classes. For example, use BRK-A for Berkshire Hathaway Class A.

Does Tiingo include delisted securities?

Tiingo documents support for delisted tickers that have not yet been recycled. That boundary matters when assembling a historical stock universe.

Get started

Start using Tiingo ticker metadata in Hermes

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Hermes:

Set up Hermes

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options