stefanprodan/1ctx-markets

A self-hosted market data server for AI agents.
It collects quotes, price history, research and news from free sources
and computes technical signals. Agents query it over
MCP, scripts over a REST API.
You can also track price alerts and portfolios, so agents know what you
hold.
It works with anything Yahoo Finance lists: shares, ETFs, indices,
futures, currencies and crypto, on any exchange. There is no ticker
list to maintain; a symbol is fetched the first time an agent asks for
it.
## Features
Quotes and signals: live prices, daily and weekly history,
moving averages, RSI, MACD, ATR, drawdown and crossings.
Research: fundamentals, analysts, earnings, insider activity,
SEC filings, news sentiment, ETF holdings, economic series and
futures positioning.
Price alerts: conditions like rsi14 sma200,
with a feed a scheduled job can poll.
Portfolios: trades, cash, bonds and funds by broker, valued live
in any currency.
Notes for agents: your investor profile, trade plans and dated
analyses per symbol, written in Markdown.
A web UI to browse all of the above and manage agent keys.
Self-hosted: one binary and one SQLite file.
## Data sources
All free. The keyed ones turn on when their key file is present:
| Source | Adds |
| Yahoo Finance | quotes, history, ETF holdings (always on) |
| CFTC | futures positioning (always on) |
| Finnhub | US shares: fundamentals, analysts, earnings, insiders |
| Massive | US shares and ETFs: news with sentiment |
| FRED | economic series such as Treasury yields |
| SEC EDGAR | US filings (the key file holds a name and email, not a key) |
| Bucharest Stock Exchange | local shares, funds and bonds (--source bvb) |
## Quick start
Download a binary for Linux (amd64, arm64) or macOS (Apple silicon)
from Releases,
or build it with Bun at the version in
.bun-version:
sh
git clone https://github.com/stefanprodan/1ctx-markets.git
cd 1ctx-markets
bun install --frozen-lockfile --ignore-scripts
make build
./bin/1ctx-markets
The server listens on 127.0.0.1:11238 and keeps its data in
~/.1ctx-markets. The first start writes an admin key to
~/.1ctx-markets/secrets/user-admin.key; use it to sign in to the web
UI and to connect agents. --help lists the options.
To add a source, put its key in a file and restart:
sh
printf '%s' ' ' > ~/.1ctx-markets/secrets/source-finnhub.key # or source-massive, source-fred
printf '%s' 'Your Name you@example.com' > ~/.1ctx-markets/secrets/source-edgar.key
chmod 600 ~/.1ctx-markets/secrets/.key
On macOS, ./bin/1ctx-markets service install runs it as a login
service.
The server speaks plain HTTP: keep it on loopback, a private network
such as Tailscale, or behind a TLS proxy.
### With Docker
From a clone of this repository, write the admin key, and the key of
any source you want, before the first start:
sh
cd deploy/docker
mkdir -p secrets
openssl rand -hex 32 > secrets/user-admin.key
printf '%s' ' ' > secrets/source-finnhub.key # optional, as above
chmod 644 secrets/.key
The container reads secrets/ read-only, so it cannot write a key of