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/quote?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

search, news, market status

Market

$0.005

quotes, history, holders, calendar

Intelligence

$0.05

financials, analysis, screener, options

Price History

GET /v1/history $0.005

Historical OHLCV price data for a single ticker.

Parameter	Type	Description
symbol	string	Ticker symbol (e.g. AAPL). Required.
period	string	1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max. Default: 1mo
interval	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)
prepost	bool	Include pre/post market data. Default: false

Quote

GET /v1/quote $0.005

Current quote and company information.

Parameter	Type	Description
symbol	string	Ticker symbol. Required.
fast	bool	Fast mode — fewer fields, 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 Status

GET /v1/market/status $0.001

Current market open/close status and session times.

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

Income Statement

GET /v1/financials/income $0.05

Revenue, net income, operating expenses, and margins.

Parameter	Type	Description
symbol	string	Ticker symbol. Required.
freq	string	yearly, quarterly, or trailing. Default: yearly

Balance Sheet

GET /v1/financials/balance-sheet $0.05

Assets, liabilities, equity, and capital structure.

Parameter	Type	Description
symbol	string	Ticker symbol. Required.
freq	string	yearly or quarterly. Default: yearly

Cash Flow

GET /v1/financials/cash-flow $0.05

Operating, investing, and financing activities.

Parameter	Type	Description
symbol	string	Ticker symbol. Required.
freq	string	yearly, quarterly, or trailing. Default: yearly

Earnings

GET /v1/financials/earnings $0.05

Historical earnings data.

Parameter	Type	Description
symbol	string	Ticker symbol. Required.
freq	string	yearly, quarterly, or trailing. Default: yearly

Price Targets

GET /v1/analysis/price-targets $0.05

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

Parameter	Type	Description
symbol	string	Ticker symbol. Required.

Recommendations

GET /v1/analysis/recommendations $0.05

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

Parameter	Type	Description
symbol	string	Ticker symbol. Required.

Estimates

GET /v1/analysis/estimates $0.05

Consensus earnings and revenue estimates with EPS trends.

Parameter	Type	Description
symbol	string	Ticker symbol. Required.

Growth

GET /v1/analysis/growth $0.05

Growth rate estimates and sustainability metrics.

Parameter	Type	Description
symbol	string	Ticker symbol. Required.

Holders

GET /v1/holders $0.005

Major holders, institutional positions, and mutual fund ownership.

Parameter	Type	Description
symbol	string	Ticker symbol. Required.
type	string	major, institutional, or mutualfund. Default: major

Insiders

GET /v1/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

Search

GET /v1/search $0.001

Search instruments by name, symbol, or keyword.

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

Screener

GET /v1/screener $0.05

Run a predefined stock screener.

Parameter	Type	Description
query	string	Predefined screener name. Required. Options: day_gainers, day_losers, most_actives, most_shorted_stocks, undervalued_growth_stocks, undervalued_large_caps, growth_technology_stocks, aggressive_small_caps, small_cap_gainers, top_mutual_funds
size	int	1–250. Default: 25
sort_field	string	Field to sort by. Default: ticker
sort_asc	bool	Sort ascending. Default: false

Custom screener

POST /v1/screener $0.05

Run a custom equity screener 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
key	string	Sector key. Required. e.g. technology, healthcare, financial-services

Industries

GET /v1/industries $0.005

Industry data — top performing and growth companies.

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

News

GET /v1/news $0.001

Calendar

GET /v1/calendar $0.005

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

Parameter	Type	Description
symbol	string	Ticker symbol (company-specific calendar)
type	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