seiche

# SEICHE

[![sealed record](https://img.shields.io/endpoint?url=https%3A%2F%2Fapi.seiche.info%2Fapi%2Fbadge%2Frecord)](https://api.seiche.info/api/notary)

> A **seiche** is a standing wave in an enclosed body of water — invisible from the
> shore, until it sloshes over the edge. Funding stress behaves the same way.

**Seiche is a free, open source (AGPL-3.0-or-later) money-, foreign-exchange and
capital-market evidence terminal** organized around the dollar funding system —
US money markets, 22 public H.10 currency reference series, the Treasury
capital-market complex, the global basins connected through swap lines, and the
offshore-dollar crypto basin moored to the T-bill market through stablecoins. The core US board and
USD desk use free official/public APIs (FRED, NY Fed Markets, OFR STFM, Treasury
FiscalData, CFTC, ECB Data Portal, DeFiLlama, Coinbase Exchange). The global
market-pack catalog can also declare licensed or tenant sources, but public
outputs obey each source's redistribution policy and never expose restricted raw
values.

Seiche publishes a construction-PIT historical diagnostic—with misses and
eligibility limits kept visible—and is now accruing a separate as-published
forward record that can be verified instead of reconstructed. Licensed terminals
provide much broader real-time data and execution workflows, while OFR and NY Fed
dashboards provide authoritative source views. Seiche is a narrower, opinionated
research layer: forward-looking, alerting-ready, and provenance-honest. It is not
a Bloomberg/Reuters replacement, a real-time quote service, or an execution venue.

## The lab

Seiche is one of three altitudes in a single liquidity lab that fills that gap:
**Seiche** reads the plumbing, **[LiquiLens](https://liquilens.in)** organizes
institution evidence for review, and **Undertow** measures market liquidity itself
(who provides depth in each segment, what an exit at position size costs
today). The wiring between the three is real, not a brochure: the desk
assistant pulls the LiquiLens failure board over MCP, the MARKET tab renders
Undertow's published pack live, and the Windfetch engine reads the FETCH pack
built in the Undertow repo back into this board. On names: the internal
composite engine called "undertow" (critical slowing down,
`engines/undertow.py`) is unrelated to the Undertow sister product.

For a first connected review, start with
[funding context in the browser](https://liquilens.in/start/?task=funding).
The shared [portfolio plan](docs/PORTFOLIO-FOCUS.md) prioritizes a recurring
reviewer task while keeping each product's evidence and authority separate.

## Use Seiche everywhere

Seiche is distributed as software, an MCP service, a research dataset, and
machine-readable catalog metadata. Status is receipt-based: **listed** means a
durable public record and receipt exist, **prepared** means an owner-controlled
submission or publication remains, and **blocked** means a named prerequisite
must clear first. “Usable in repo” describes local artifact readiness, not a
ledger status. The auditable source of truth is
[`distribution/submissions.csv`](distribution/submissions.csv).

| Surface | What is available | Status |
|---|---|---|
| **OpenBB** | Typed provider and `obb.seiche` router for funding stress, world markets, and data health ([extension](integrations/openbb/)) | Usable/tested in repo; signed 0.1.0 PyPI publication and current ecosystem-list submission packet prepared |
| **Zenodo** | Release deposition metadata, citation identity, and related-source records ([metadata](.zenodo.json)) | Prepared; no deposit or DOI claimed |
| **Hugging Face** | Rights-reviewed direct-OFR dataset card and staging layout ([dataset card](distribution/datasets/huggingface/README.md)) | Validated draft; upload prepared |
| **Kaggle** | Dataset metadata and reference-only staging layout ([metadata](distribution/datasets/kaggle/dataset-metadata.json)) | Validated draft; upload prepared |
| **Smithery** | Owner-published hosted endpoint entry ([live record](https://smithery.ai/servers/mrinallovesbhature/seiche)) | Listed but stale; authenticated rescan pending |
| **MCP directories** | Official Registry, Glama, Smithery, and eight additional live indexes ([dated inventory](distribution/MCP_DIRECTORIES.md)) | 11 live records; claim/freshness gaps tracked |
| **Research notebooks** | Commit-pinned, hash-checking direct-OFR workflow ([notebook](notebooks/seiche_direct_ofr_research.ipynb)) | Usable in repo |
| **Python / R / JavaScript** | Zero-secret world-markets API clients with evidence-contract checks ([clients](clients/)) | Usable in repo |
| **Market Atlas + structured corpus** | Interactive canonical market observations, rights-aware dataset receipts, full normalized BIS records, Seiche partitions, public API and MCP ([contract](docs/MARKET_CORPUS.md)) | Live gateway; protected exports remain restricted and bulk records use bounded snapshot cursors |
| **Docker** | Distroless, non-root, read-only Compose image and signed GHCR publication workflow ([guide](docs/DISTRIBUTION.md)) | Built and tested locally; GHCR prepared |
| **Academic dataset** | 10 direct-OFR series and 11,163 audited observations, excluding restricted and derived rows ([research kit](distribution/datasets/README.md)) | Validated draft; not submitted |
| **Data catalogs** | Native-validated Croissant/Frictionless, graph-parsed DCAT 3/RO-Crate 1.3, and a DOI-free DataCite planning draft ([metadata kit](distribution/datasets/)) | Validated as labeled; publication prepared |
| **AI integrations** | Hosted MCP configs for Claude Code, Cursor, VS Code, Gemini CLI, and Codex; separate OpenAI workspace/submission guidance ([configs](integrations/mcp-clients/)) | Configs usable; OpenAI listing prepared |
| **PyPI** | Python package and stdio MCP server (`pip install seiche`) | Repository version 0.13.4; immutable availability is authoritative only on the linked PyPI project |

Version **0.13.4 estuary** keeps blocking source-cache work off the API request
loop and publishes snapshot readiness together with its saved evidence. Market
Atlas publication verifies refreshed BIS materializations separately from the
signed release baseline. Deployment and immutable package publication remain
subject to the signed release gates.

The verified NY Fed historical importer covers 34 canonical instruments.
Archived observations retain unknown publication
clocks and actual ingestion times, preserve existing live vintages, and remain
excluded from forecast inputs that require known publication clocks. The
structured funding, forex and China workbench retains exact source dates, units,
capture evidence and missing states. Numerical China context requires its
independent signed acceptance. Verify deployment and package availability from
the release receipts and linked registries.

Fourteen evidence tools remain anonymous and free. Five compute-heavy tools are
account-gated; client and catalog copy must preserve that boundary. See the
[distribution and container trust guide](docs/DISTRIBUTION.md) for verification
and release invariants.

## v2 "Deep Water" — an accountable engine fleet, layered analytics, one terminal

> **v2.3 "Letters of Marque"** (built in tandem across two sessions) adds the
> forecast layer and the layer that makes every other layer accountable:
> **Undertow** (critical slowing down — the basin's damping, measured on
> ordinary days), the **Swell Forecast** (the funding-stress forward curve —
> P(pop ≥ x bp) by date, six weeks out, from the public forcing calendar),
> **The Stack** (walk-forward ensemble of every event forecaster — rule, ML,
> analogs, Swell — plus The Tell, with a disagreement gauge), **The Book**
> (HELM tab — explicit daily positions on 2y/10y duration proxies, S&P and
> BTC over a T-bill base, walk-forward P&L with costs, block-bootstrap Sharpe
> CIs and mandatory benchmarks, verdict printed even when it loses), a
> **hash-chained as-published track record** shipped inside the static
> publish (nobody, including the operator, can quietly rewrite a bad month),
> and the **Far Basin** — Palimpsest's censorship-fear channel
> (palimpsest.info), a policy confession signal no market data vendor
> carries, honestly quarantined until it accrues testable history.

| Engine | Question it answers |
|---|---|
| **Kink Engine** | Where does reserve scarcity start, and how many days away is it at the current drain rate? (live hockey-stick fit of SOFR−IORB vs reserves/GDP) |
| **Liquidity Weather** | What does the reserve path look like 6 weeks out — and which auction-settlement days land on thin ice? (TGA seasonal model + Fed drift + settlement calendar + backtested error bands) |
| **Tail Seismograph** | Are the P99 tails of SOFR/TGCR/BGCR detaching from the median — the first tell of every squeeze? |
| **USD Money Market Desk** ★ | Seven institutional-depth sections over the US cash system: policy corridor and overnight spreads; SOFR/TGCR/BGCR distributions and tails; repo-segment rates and volumes; CP−Treasury spreads; bills; liquidity buffers and Fed facilities; and MMF repo plumbing. Cross-source arithmetic uses exact common dates, repo aggregates require a fixed component set, and the descriptive NORMAL/WATCH/STRAIN/STRESS label uses a dependence-robust family-wise adjustment rather than an uncalibrated maximum. |
| **Global Money Market Atlas** ★ | A licence-aware, native-frequency catalog and available-evidence comparison across 11 registered monetary-area packs, plus a dated source-audited discovery ledger of 52 additional monetary areas across nine regions. Registration and discovery are not live coverage. Each available market is compared only with its own history and can be `LIVE_REFERENCE`/`STALE_REFERENCE`, `DERIVED_CONTEXT`, `POLICY_ONLY`, or `DECLARED_UNAVAILABLE`; no global stress score is manufactured from unlike rate levels. |
| **Echo Engine** | Does today's 30-day trajectory rhyme with the run-up