# SnowSignals

> SnowSignals is a market-data platform (data-as-a-service). This server exposes TrendVane — its multi-timeframe market-phase model, one of several SnowSignals data products (more, including exchange-premium feeds and partner signals, are added over time). A TrendVane 'phase' labels the current market state for a currency on a timeframe. TrendVane reports state, not a forecast or a trade signal: it names which phase the market is in, not what to do about it, so you bring your own strategy. (Signal products under SnowSignals, like the exchange-premium feeds noted above, are a different thing; TrendVane is deliberately not one.) Call list_phase_meta first for the enabled phases, timeframes and currencies. Read live phases with get_phase / compose_phases: 'boundary' is the last closed-bar deterministic truth, 'updates' is the intra-bar read. To INTERPRET a phase — what it implies and how it typically resolves — call phase_resolution_stats: it returns successor-phase transition probabilities, trend-continuation rates, and reward-vs-drawdown (MFE/MAE) per phase (a BTC research model over the current market regime, 2022–2026 — every number carries its count, no hidden n). list_phase_meta and phase_resolution_stats are free and need no authentication — call them first, even before OAuth. list_phase_meta also carries the pricing model (base rate and multiplier tiers), so you can work out what a metered call costs before making it. get_notifications, get_balance and get_usage are unmetered but read your own account, so they require your credential. get_balance also lists the deposit addresses on your account; to add one, sign in to the web dashboard. After you send a deposit, call deposit_poll so a lagging hot wallet notices it sooner. get_phase and compose_phases are metered per call.

## How to consume this data

SnowSignals is a Model Context Protocol (MCP) server, not a browsable REST site. To read data,
connect an MCP client to the endpoint below and speak JSON-RPC 2.0 over POST — a bare GET will not
enumerate the tools (that is by design; call `tools/list` after `initialize`).

- MCP endpoint: `https://snowsignals.io/mcp` (transport: streamable-http, protocol 2025-06-18)
- Free, no-auth tools to call first: `list_phase_meta`, `phase_resolution_stats`
- OAuth discovery (for metered/account tools, scope `daas:read`): `https://snowsignals.io/.well-known/oauth-protected-resource`
- OpenAPI (the equivalent REST surface): `https://snowsignals.io/v1/openapi.json`
- Human docs (client-rendered): `https://snowsignals.io/docs`

## Coverage

- Timeframes: 15m, 1h, 2h, 4h, 1d, 1w
- Currencies: BTC, ETH, GRAM, SOL, TRX
- Phase classes: establishing_bull, establishing_bear, running_reentry_bull, running_reentry_bear, running_first_bull, running_first_bear, consolidating_bull, consolidating_bear, running_post_fe_bull, running_post_fe_bear, breaking_bull, breaking_bear

## Tools

- **list_phase_meta** (no auth) — The tool to call first, and it's free with no account. Lists the phases the model can report, the timeframes and currencies covered, and a short card for each phase explaining what it means and what tends to come next. Also returns the current pricing, so you can work out what a paid call costs before you make one.
- **phase_resolution_stats** (no auth) — Free, and how you read meaning into a phase. For each one it shows what usually happens next, how often a trend keeps running, and how the typical move rewarded you against how far it drew down first. Every figure comes with the number of past cases behind it. It's a behavior model built from years of Bitcoin history, not live per-coin data, so pair it with get_phase.
- **get_notifications** (OAuth bearer (daas:read)) — Read your account messages: support, billing, and account notices. With no arguments you get the ten most recent in each group, each with a cursor; pass a category and cursor to page further back. It's read-only and free, and it never marks anything as read. Security alerts aren't available here, and any group you've switched off for API access won't show up.
- **get_balance** (OAuth bearer (daas:read)) — Check your prepaid balance before a paid call. Shows the credit you have left to spend, anything on hold, any bonus credit and when it expires, whether the account is paused, the current pricing, and the deposit addresses on your account. It's free. If you run out, paid calls are turned away until you top up. To add a deposit address, sign in to the web dashboard.
- **get_usage** (OAuth bearer (daas:read)) — Your history of paid calls, newest first. For each one it shows which tool you used, the coins and timeframes, how much data came back, and what it cost. Free. Page back through older calls with `before`, using the cursor the previous page returned.
- **deposit_poll** (OAuth bearer (daas:read)) — Call this right after you send a stablecoin deposit to have it picked up sooner: it tells the system to check your deposit addresses now. It moves no money and is free. If it comes back with nothing, you don't have a deposit address yet, so add one from the web dashboard.
- **get_phase** (OAuth bearer (daas:read)) — Get the current market phase for one coin, across a timeframe. This is a paid call. Set `kind` to 'boundary' for the reading from the last closed bar, which is settled and won't change, or 'updates' for the live reading still forming inside the current bar. Leave `tf` off, or set it to 'all', for every timeframe.
- **compose_phases** (OAuth bearer (daas:read)) — Get phases for several coins and timeframes in one paid call. Set `kind` to 'boundary' for the settled last-closed-bar reading or 'updates' for the still-forming one. The cost scales with how many readings come back, which is your coins times your timeframes.