API Reference

Structured financial intelligence accessible to any HTTP client. All endpoints use the Machine Payments Protocol — no API keys required.

Authentication

Trellis uses MPP (Machine Payments Protocol) for authentication and billing. There are no API keys or accounts to create.

Send a request to any paid endpoint. You'll receive a 402 Payment Required response with a WWW-Authenticate: Payment header. Your client pays the specified amount on Tempo and retries with the payment credential. The whole round-trip takes under a second.

Using the Tempo CLI, this is automatic:

tempo request -X GET https://api.trellismarket.com/v1/snapshot?symbol=AAPL

Base URL

https://api.trellismarket.com

All endpoints return JSON. Responses include a Payment-Receipt header confirming the transaction.

Pricing

Three tiers, billed per request at the moment of use.

Data

$0.001

lookup, news, market session

Market

$0.005

snapshots, prices, ownership, calendar

Intelligence

$0.05

fundamentals, consensus, screening, options

Prices

GET /v1/prices $0.005

Historical OHLCV price data for a single ticker.

Parameter	Type	Description
symbol	string	Ticker symbol (e.g. AAPL). Required.
range	string	1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max. Default: 1mo
resolution	string	1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3mo. Default: 1d
start	string	Start date (YYYY-MM-DD)
end	string	End date (YYYY-MM-DD)
extended	bool	Include extended-hours trading data. Default: false

Snapshot

GET /v1/snapshot $0.005

Current snapshot and company information.

Parameter	Type	Description
symbol	string	Ticker symbol. Required.
lite	bool	Lite mode — key metrics only, lower latency. Default: false

Options

GET /v1/options $0.05

Option chain — calls, puts, and available expirations.

Parameter	Type	Description
symbol	string	Ticker symbol. Required.
expiration	string	Expiration date (YYYY-MM-DD), or omit for nearest.

Market Session

GET /v1/market/session $0.001

Current market session status — open/closed, session times.

Parameter	Type	Description
market	string	Market code (e.g. US, GB, JP). Default: US

Income Statement

GET /v1/fundamentals/income $0.05

Revenue, net income, operating expenses, and margins.

Parameter	Type	Description
symbol	string	Ticker symbol. Required.
period	string	annual, quarterly, or ttm. Default: annual

Balance Sheet

GET /v1/fundamentals/balance-sheet $0.05

Assets, liabilities, equity, and capital structure.

Parameter	Type	Description
symbol	string	Ticker symbol. Required.
period	string	annual or quarterly. Default: annual

Cash Flow

GET /v1/fundamentals/cash-flow $0.05

Operating, investing, and financing activities.

Parameter	Type	Description
symbol	string	Ticker symbol. Required.
period	string	annual, quarterly, or ttm. Default: annual

Earnings

GET /v1/fundamentals/earnings $0.05

Historical earnings data.

Parameter	Type	Description
symbol	string	Ticker symbol. Required.
period	string	annual, quarterly, or ttm. Default: annual

Targets

GET /v1/consensus/targets $0.05

Consensus analyst price targets — current, low, high, mean, median.

Parameter	Type	Description
symbol	string	Ticker symbol. Required.

Ratings

GET /v1/consensus/ratings $0.05

Analyst buy/sell/hold ratings and upgrade/downgrade history.

Parameter	Type	Description
symbol	string	Ticker symbol. Required.

Estimates

GET /v1/consensus/estimates $0.05

Consensus earnings and revenue estimates with EPS trends.

Parameter	Type	Description
symbol	string	Ticker symbol. Required.

Outlook

GET /v1/consensus/outlook $0.05

Forward growth projections and sustainability metrics.

Parameter	Type	Description
symbol	string	Ticker symbol. Required.

Ownership

GET /v1/ownership $0.005

Ownership summary, institutional positions, and fund holdings.

Parameter	Type	Description
symbol	string	Ticker symbol. Required.
scope	string	summary, institutional, or fund. Default: summary

Insiders

GET /v1/ownership/insiders $0.005

Insider transactions, purchases, and company insider roster.

Parameter	Type	Description
symbol	string	Ticker symbol. Required.
view	string	transactions, purchases, or roster. Default: transactions

Lookup

GET /v1/lookup $0.001

Search instruments by name, symbol, or keyword.

Parameter	Type	Description
query	string	Search query. Required.
limit	int	1–25. Default: 8

Screen

GET /v1/screen $0.05

Run a predefined equity screen.

Parameter	Type	Description
preset	string	Predefined screen. Required. Options: top_movers, declining, high_volume, high_short_interest, value_growth, value_large_cap, tech_growth, small_cap_momentum, small_cap_movers, top_funds, high_yield, blue_chip, intl_conservative, large_growth_funds, mid_growth_funds
size	int	1–250. Default: 25
sort_by	string	Field to sort by. Default: ticker
ascending	bool	Sort ascending. Default: false

Custom screen

POST /v1/screen $0.05

Run a custom equity screen with a query expression.

{
  "operator": "AND",
  "operands": [
    { "operator": "GT", "operands": ["percentchange", 3] },
    { "operator": "EQ", "operands": ["region", "us"] }
  ]
}

Operators: AND, OR, EQ, IS-IN, BTWN, GT, GTE, LT, LTE

Sectors

GET /v1/sectors $0.005

Sector overview — top companies, ETFs, mutual funds, and industries.

Parameter	Type	Description
id	string	Sector identifier. Required. e.g. technology, healthcare, financial-services

Industries

GET /v1/industries $0.005

Industry data — top performing and growth companies.

Parameter	Type	Description
id	string	Industry identifier. Required. e.g. software-application, biotechnology

News

GET /v1/signals/news $0.001

Calendar

GET /v1/signals/calendar $0.005

Earnings dates, IPOs, economic events, and stock splits. Pass symbol for company-specific or kind for market-wide.

Parameter	Type	Description
symbol	string	Ticker symbol (company-specific calendar)
kind	string	earnings, ipo, economic, or splits. Default: earnings
start	string	Start date (YYYY-MM-DD)
end	string	End date (YYYY-MM-DD)
limit	int	1–100. Default: 25