vorepo API

REST endpoints for market data, trading, and signals. All responses are JSON unless otherwise noted. Prices are tabular-numeral USD decimals. Timestamps are ISO-8601 UTC. Read endpoints are public; trading requires a Bearer JWT.

Base URL

https://vorepo.com/api

Auth

Authorization: Bearer <jwt>

Rate limit

30 req/s per IP · 100K/day Pro

◆ Overview

vorepo exposes a small set of REST endpoints. Read endpoints (market data, charts, search) are anonymous and rate-limited per IP. Trading and admin endpoints require a Bearer JWT obtained from the /api/auth/login flow. The complete machine-readable contract is available as openapi_snapshot.json.

◆ Authentication

Read endpoints: no auth. Trading endpoints: Authorization: Bearer <token>. Admin: Bearer JWT with email in ADMIN_EMAILS env. API tier users get a long-lived machine-to-machine key from the dashboard.

◆ Rate limits

Tier	Rate	Burst	Daily
Anonymous	30 req/s	60	100K
Free (logged in)	60 req/s	120	500K
Plus ($20/mo)	100 req/s	250	1M
Starter ($500)	200 req/s	500	10K req/day fixed
Pro ($2K)	500 req/s	1K	100K req/day
Enterprise ($5K)	dedicated	—	1M req/day

GET /api/repos

List all markets

Returns paginated list of active repo tickers. Orderable by stars, velocity, price, or 24h change.

Query parameters

Param	Type	Default	Description
limit	int	100	1..500
offset	int	0	Pagination offset
order	enum	`stars`	`stars`, `velocity`, `price`, `change`
category	string	—	Filter: web, ai-ml, systems, tools, data, crypto, security, gamedev, education

Example

curl

curl https://vorepo.com/api/repos?limit=5&order=velocity

GET /api/repo/{ticker}

Repo detail

Full metadata for a single ticker — description, topics, license, GitHub URL, all live metrics.

Example

curl

curl https://vorepo.com/api/repo/FACREACT

GET /api/repo/{ticker}/chart

OHLC candles

Historical OHLC price data, UTC-aligned buckets. Used by the terminal chart and portfolio equity views.

Query parameters

Param	Type	Default	Description
timeframe	enum	`1h`	`1h`, `4h`, `1d`
hours	int	168	Lookback hours (1..8760)

Example

curl

curl "https://vorepo.com/api/repo/FACREACT/chart?timeframe=1h&hours=168"

GET /api/repo/{ticker}/orderbook

Synthetic order book

Synthetic bids/asks seeded from mid-price. Spread scales with star velocity. NOT tradable — visualisation only. Use /quote and /trade for price discovery.

Example

curl

curl "https://vorepo.com/api/repo/FACREACT/orderbook?depth=10"

GET /api/repo/{ticker}/quote

Price quote

Non-binding quote for a given side+quantity. Returns impact price, fee, and total. No auth required, free to poll.

Query parameters

Param	Type	Required	Description
side	enum	yes	`buy` or `sell`
quantity	float	yes	Shares (min 0.001)

Example

curl

curl "https://vorepo.com/api/repo/FACREACT/quote?side=buy&quantity=10"

POST /api/repo/{ticker}/trade

Execute trade

Place a bonding-curve market buy or sell. Settles against the on-chain reserve pool. Requires Bearer JWT.

Request body

JSON

{
  "side": "buy",
  "quantity": 10.5
}

Example

curl

curl -X POST https://vorepo.com/api/repo/FACREACT/trade \
  -H "Authorization: Bearer $VOREPO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"side": "buy", "quantity": 10}'

GET /api/alpha-signals

Alpha signals

Repos currently trading above N standard deviations of the platform mean velocity. "Hot right now" feed.

Example

curl

curl "https://vorepo.com/api/alpha-signals?sigma=2&limit=20"

GET /api/repos/search

Search

Case-insensitive substring match on ticker, owner, name, or full repo name. Exact ticker matches boosted to top.

Example

curl

curl "https://vorepo.com/api/repos/search?q=ollama&limit=5"

GET /api/repos.csv

CSV export

Bulk export of all active repos as CSV — for B2B consumers running their own pipelines. Content-Disposition attachment.

Example

curl

curl -o vorepo_$(date +%Y%m%d).csv \
  "https://vorepo.com/api/repos.csv?category=ai-ml"

GET /api/badge/{ticker}.svg

Embeddable badge

Shields.io-style SVG pill for README embedding. Left half = vorepo logo, right half = live ticker + price + 24h %chg, colour follows direction (mint up / red down). 2-min CDN cache.

Example

MARKDOWN

![vorepo momentum](https://vorepo.com/api/badge/FACREACT.svg)

Live preview

Paste this URL into any repo README. Updates every 2 minutes.

GET /api/card/{ticker}.svg

Social share card

1200×630 SVG for Open Graph / Twitter card previews. Renders ticker, full repo name, current price, 24h change, stars, velocity, and a Bézier-smoothed 24h spark in the repo's colour. 2-minute CDN cache.

Example

OG META TAG

<meta property="og:image" content="https://vorepo.com/api/card/FACREACT.svg">

Live preview

GET /api/embed/{ticker}

Embed iframe card

Standalone 200-height HTML card designed for <iframe> embedding in blogs, docs sites, or personal pages. Live price + 24h change + Bézier spark. Auto-links to the trading terminal on click. Text/html response, 2-min cache.

Example

HTML

<iframe src="https://vorepo.com/api/embed/FACREACT"
        width="360" height="200" frameborder="0"
        title="vorepo FACREACT live card"></iframe>

Live preview

Configurator

For a visual configurator with copy buttons for all three embed formats (badge SVG, embed iframe, ticker strip), see /widget.html.

GET /api/stats/public

Platform stats

Non-sensitive platform counts — total repos, scrape freshness, GH API usage, pending queue. Powers the status page.

Example

curl

curl https://vorepo.com/api/stats/public

GET /api/health

Health check

Returns {"status": "ok"} if DB + config reachable.

Example

curl

curl https://vorepo.com/api/health