get-started2.45 KB
View saved version →
---
name: get-started
description: Introduce TickerLayer when the user has just connected it, asks what TickerLayer can do, how to start, or wants example questions. Explains the market data available, offers the interactive markets board and suggests first questions. Do not use it to answer an actual market data question; the market-data skill covers those.
---
# Getting started with TickerLayer
Use this when the user is new to TickerLayer or asks what it can do. Keep the
introduction short: three or four sentences, then one offer.
## What to say
1. **What it is.** TickerLayer reads market data for crypto, forex, stocks,
indices, ETFs, commodities, perpetual futures and government bond yields.
Every tool only reads data; nothing can be bought, sold or changed.
2. **What the user can ask.** A price or today's move, a comparison between
two instruments, price history over a period, whether a market is open and
its hours and holidays, or a bond yield.
3. **Offer the board.** Offer to open the markets board
(`open_markets_board`): ten widely followed markets with a chart for each
and a search box for everything else. Open it only if the user says yes or
asked for an overview.
## Example first questions
Suggest two or three that fit what the user seems interested in:
- "Open the TickerLayer markets board"
- "How is Bitcoin doing versus gold today?"
- "Compare Nvidia and Tesla over the past month"
- "What is EUR/USD now, and how has it moved this week?"
- "Is the London market open right now?"
## Things to get right
- **Plans.** A free account reads crypto, forex and US stocks, and spot gold
and silver prices. Other data (indices, ETFs, other commodities, bond
yields, stocks outside the US, perpetual futures) depends on the account's
plan. If a call answers that the data is not part of the
plan, relay that plainly and point to https://tickerlayer.com/pricing once.
Do not describe prices, discounts or trials, and do not urge an upgrade.
- **Data notice.** TickerLayer data is derived and indicative. It is not
sourced from any exchange and is not investment advice. Say so once when
the user is about to act on a number.
- **No advice.** Report data and facts. Do not recommend buying, selling or
holding anything.
- **Do not burn requests.** Each data call counts against the user's monthly
allowance. Do not call tools just to demonstrate them.
After the introduction, hand over to the market-data skill for any real
question.
market-data12.9 KB
View saved version →
---
name: market-data
description: Query latest and historical market data through the TickerLayer MCP server, including quotes, snapshots, OHLCV history, symbol discovery, market hours and holidays, government bond yields and an interactive markets board, across crypto, forex, stocks, indices, ETFs, commodities and perpetual futures. Use whenever the user asks about a price, a market move, an exchange rate, candle or chart history, whether a market is open, a bond yield, or a market overview, and the TickerLayer tools (get_snapshot, get_history, list_symbols, open_markets_board, and the rest) are available.
---
# TickerLayer Market Data
Answer market questions with the TickerLayer MCP tools. The tools are the
complete surface. Never construct or guess REST URLs. If a call fails, report
what failed instead of filling the gap with remembered or estimated prices.
## Picking the right tool
| Question shape | Tool |
| --- | --- |
| "How is X doing?" Last price and change against the previous close in one call | `get_snapshot` |
| Current bid/ask spread | `get_quote` |
| Most recent trade (price, size, time) | `get_last_trade` |
| A confirmed close: yesterday's daily bar, or the latest settled intraday bar | `get_previous_close` |
| Chart data, ranges, "over the last month" | `get_history` |
| "What symbols do you have?" or resolving a fuzzy name | `list_symbols` |
| "Is the market open?" | `get_market_status` |
| Trading hours and session times | `get_market_sessions` |
| Upcoming or past market holidays | `get_market_holidays` |
| Government bond yields (US:10Y, DE:10Y, ...) | `get_bond_yield` |
| A broad market overview, or "open TickerLayer" | `open_markets_board` |
`search_symbols` powers the search box inside the markets board. Use
`list_symbols` for your own lookups.
Rules of thumb:
- **Every data tool needs `asset_class` as well as `symbol`.** `get_quote`,
`get_last_trade`, `get_snapshot`, `get_previous_close` and `get_history` all
require `asset_class`, one of `crypto`, `forex`, `stocks`, `indices`, `etfs`,
`commodities`, `perpetuals`. Choose it deliberately: `XAUUSD` is commodities,
`EURUSD` is forex, `XAUUSDT` is perpetuals, and a wrong class resolves to the
wrong instrument or a 404.
- **`get_snapshot` is the best single call** for "how is X doing". It bundles
the last price, bid and ask, the previous close, and the change and percent
change. Prefer it over stitching `get_quote` and `get_previous_close`
together. `get_quote` returns only bid, ask and sizes, so it is not the tool
for "what's the price".
- **`get_previous_close` with `interval`** returns the latest fully settled bar
of that interval (for example the last completed 1-hour bar), not only
yesterday's daily close. The values are exactly `1m`, `5m`, `15m`, `1h`,
`4h`, `1d`. Omit it for the previous daily bar. Use it when the user wants a
confirmed, non-live value.
- **`get_history` has no `interval` parameter.** The bar size is `multiplier`
plus `timespan`: `1`, `5` or `15` with `minute`; `1` or `4` with `hour`; `1`
with `day`. No other pair is valid. `from` and `to` are UTC dates in
`YYYY-MM-DD`. `limit` (default 500, max 5000) and `sort` (`asc` or `desc`,
default `desc`) are optional.
- **One `get_history` request covers a limited span**, and the span is shorter
for smaller bars. A range that is too large returns a 400 that names the
maximum, so split it into consecutive requests. A non-null `next_offset`
means more bars matched than `limit` returned: raise `limit` or narrow the
dates.
- **Bonds go through `get_bond_yield` only.** The value is a yield in percent,
not a price, and it is a daily observation. Do not ask the quote tools for
bond symbols.
- **`open_markets_board` costs ten requests**, one per row, on the user's plan
(Bitcoin, Ethereum, Solana, EUR/USD, USD/JPY, GBP/USD, gold, silver, Nvidia
and Tesla; its search box reaches every other instrument),
and each chart, search or refresh inside
Preview of the first 4,000 characters. Read full instructions →
Referenced files: 1 — file references are metadata, not package contents.