# Trellis — Financial Intelligence API

> Structured financial intelligence for autonomous agents.
> Real-time and historical market data, fundamental analysis, consensus models,
> proprietary screening, and event signals across global equities, ETFs, and funds.

## Authentication

All paid endpoints use the Machine Payments Protocol (MPP).
Send an unauthenticated request to receive a 402 challenge, then pay via Tempo and retry with your credential.
Free endpoints: GET /, GET /health, GET /llms.txt, GET /docs

## Pricing

- Data tier ($0.001): /v1/market/session, /v1/lookup, /v1/signals/news
- Market tier ($0.005): /v1/snapshot, /v1/prices, /v1/ownership, /v1/ownership/insiders, /v1/signals/calendar, /v1/sectors, /v1/industries
- Intelligence tier ($0.05): /v1/fundamentals/*, /v1/options, /v1/consensus/*, /v1/screen

## Endpoints

### Market Data

GET /v1/prices?symbol={symbol}&range=1mo&resolution=1d&start=&end=&extended=false
  Historical OHLCV price data. Ranges: 1d,5d,1mo,3mo,6mo,1y,2y,5y,10y,ytd,max.
  Resolutions: 1m,2m,5m,15m,30m,60m,90m,1h,1d,5d,1wk,1mo,3mo.

GET /v1/snapshot?symbol={symbol}&lite=false
  Current snapshot and company information. Set lite=true for key metrics only.

GET /v1/options?symbol={symbol}&expiration=
  Option chain — calls, puts, and available expirations.

GET /v1/market/session?market=US
  Market session status — open/closed, session times.

### Fundamentals

GET /v1/fundamentals/income?symbol={symbol}&period=annual
  Income statement — revenue, net income, operating expenses, margins.
  period: annual, quarterly, ttm.

GET /v1/fundamentals/balance-sheet?symbol={symbol}&period=annual
  Balance sheet — assets, liabilities, equity, capital structure.
  period: annual, quarterly.

GET /v1/fundamentals/cash-flow?symbol={symbol}&period=annual
  Cash flow — operating, investing, financing activities.
  period: annual, quarterly, ttm.

GET /v1/fundamentals/earnings?symbol={symbol}&period=annual
  Historical earnings data.

### Consensus Intelligence

GET /v1/consensus/targets?symbol={symbol}
  Consensus analyst price targets — current, low, high, mean, median.

GET /v1/consensus/ratings?symbol={symbol}
  Analyst buy/sell/hold ratings and upgrade/downgrade history.

GET /v1/consensus/estimates?symbol={symbol}
  Consensus earnings and revenue estimates with EPS trends.

GET /v1/consensus/outlook?symbol={symbol}
  Forward growth projections and sustainability metrics.

### Ownership & Insiders

GET /v1/ownership?symbol={symbol}&scope=summary
  Shareholder data. scope: summary, institutional, fund.

GET /v1/ownership/insiders?symbol={symbol}&view=transactions
  Insider activity. view: transactions, purchases, roster.

### Discovery & Screening

GET /v1/lookup?query={query}&limit=8
  Search instruments by name, symbol, or keyword.

GET /v1/screen?preset={preset}&size=25&sort_by=ticker&ascending=false
  Predefined screens: 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.

POST /v1/screen?size=25&sort_by=ticker&ascending=false
  Custom screen. Body: {"operator": "AND", "operands": [{"operator": "GT", "operands": ["percentchange", 3]}]}

GET /v1/sectors?id={sector_id}
  Sector overview — top companies, ETFs, mutual funds, industries.
  IDs: technology, healthcare, financial-services, consumer-cyclical, etc.

GET /v1/industries?id={industry_id}
  Industry data — top performing and growth companies.

### Signals & Events

GET /v1/signals/news?symbol={symbol}&limit=10
  Latest news articles.

GET /v1/signals/calendar?symbol={symbol}
  Company-specific earnings calendar and upcoming dates.

GET /v1/signals/calendar?kind=earnings&start=&end=&limit=25
  Market-wide calendar. kind: earnings, ipo, economic, splits.