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

Instinct · Finance

How to Use Tiingo ticker search in Instinct

Find assets in Tiingo's database by ticker or name, with results identifying the asset name, type, and active or delisted status. Use it to resolve a company or fund name before requesting market data.

Prompts to try with Tiingo ticker search in Instinct

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

Every Monday, use Tiingo ticker search for AAPL, MSFT, and NVDA and report any changes in their returned names or activity status.

Tiingo ticker searchInstinct
Try asking
  • Each week, use Tiingo ticker search for SPY, VTI, and VFINX and report changes in the returned asset types or active status.

  • Every Friday, use Tiingo ticker search for BRK-A and BRK-B and flag any change in their returned symbols or names.

  • Once a month, use Tiingo ticker search for Lehman Brothers, including delisted assets, and report changes in the returned matches.

  • Each Monday, use Tiingo ticker search for NVIDIA and report whether the returned names and symbols differ from the previous check.

How to set up Tiingo ticker search in Instinct

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

Use the Spiral skill

  1. Send Instinct 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. Create an API key

    In the console, open API keys and create a key for Instinct. Copy it.

  2. Send Instinct this message

    Instinct reads Spiral's skill and asks for your API key.

    set up https://spiral.ai/SKILL.md
  3. Give Instinct the key

    When Instinct asks for the key, add it where Instinct keeps secrets, never in the chat itself.

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 search

    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/symbols/search",
        "input": {
          "query": "<query>"
        }
      }'

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

Tiingo ticker search providers and prices

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

AlexandriaFinance
Tiingo · Symbol search
tiingo/symbols/search

Settings you can ask for

Ask Instinct for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Limit1 to 100

Matches to return, from 1 to 100. Default 10.

Include delistedon or off

When true, include delisted tickers. Default false.

Exact ticker matchon or off

When true, only exact ticker matches. Names are not searched. Default false.

Every API field of Tiingo · Symbol search is on its tool page: open its card above.

What can you do with Tiingo ticker search in Instinct?

Flag changes in how Tiingo identifies a fixed list of public securities. A scheduled agent can repeat searches and report changes in returned names, asset types, and active status.

Resolve company names before market research

Search for Microsoft or NVIDIA and compare the returned names and tickers before choosing an asset for further research.

Check symbols in an imported watchlist

Look up AAPL, MSFT, and NVDA to review the corresponding asset names, types, and active status before using an imported list.

Separate fund and stock matches

Search for Vanguard and organize the returned candidates by asset type to narrow a fund research list.

Resolve share classes

Look up BRK-A and BRK-B separately and compare their returned names before selecting a Berkshire Hathaway security.

Review delisted asset references

Search for Lehman Brothers, including delisted results, to inspect the symbols and activity status Tiingo returns for historical research.

Monitor a fixed research list

Repeat searches for selected company or fund names and flag changes in returned names, asset types, or active status for review.

Questions about Tiingo ticker search in Instinct

Can Instinct use Tiingo ticker search?

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

How much does Tiingo ticker search cost in Instinct?

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 Instinct plan is separate.

Do I need an Alexandria account to use Tiingo ticker search in Instinct?

You need no Alexandria account. Instinct uses one Spiral API key for every tool, and Spiral runs Tiingo ticker search on its own Alexandria account.

How long does it take to set up Tiingo ticker search in Instinct?

About two minutes: create an API key, then send Instinct this message, then give Instinct the key.

Does Instinct wait while Tiingo ticker search runs?

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

What kinds of assets does Tiingo search return?

The documented asset types are stocks, ETFs, and mutual funds. Results identify the ticker, asset name, asset type, and whether the ticker is actively quoted.

How does Tiingo match a search?

Tiingo searches for ticker matches first, then expands to matches in the asset name. Compare the returned names and asset types when a search produces several candidates.

Is the search response stable?

Tiingo currently labels search early beta and says response objects can change. Its documentation recommends against building production code with the endpoint while it remains in beta.

How frequently does Tiingo refresh its ticker directory?

Tiingo says its downloadable supported-ticker list is updated daily. That schedule describes the directory download, rather than a guaranteed refresh schedule for search results.

Can I publish Tiingo search results?

Tiingo's terms restrict API data to internal consumption. Redistribution requires Tiingo's permission, including when the underlying companies and funds are public.

Get started

Start using Tiingo ticker search in Instinct

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

Paste this into Instinct:

Set up Instinct

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