Market Data Resource
API v1

API Documentation

Authenticate with an X-API-Key header. All responses are JSON.

Authentication

Include your API key in every request:

curl -H "X-API-Key: YOUR_API_KEY" \
  https://marketdataresource.com/api/v1/quotes?symbol=SPY
GET
/v1/quotes

Stock Quotes

Latest quote for a symbol, delivered at your plan's delay. Live plans get real-time quotes; delayed plans get the newest real-time snapshot at least 5, 10 or 15 minutes old. "realtime" is true only for genuinely live data; "stale" marks a previous-session close.

Parameters

symbolTicker symbol (e.g. SPY). Omit for a list of recent quotes.

Example Response

{
  "symbol": "SPY",
  "price": 766.21,
  "bid": 766.21,
  "ask": 766.26,
  "mid": 766.235,
  "timestamp": "2026-10-27T14:28:48Z",
  "source": "ibkr_live",
  "realtime": true,
  "delayed": false,
  "stale": false
}
GET
/v1/bars

Price Bars

OHLCV bars for a completed session (minute bars include extended hours, times in US/Eastern). Response headers X-Data-Source and X-Data-As-Of describe where the data came from.

Parameters

symbol
required
Ticker symbol (e.g. SPY)
interval1min or 1day. Default: 1min
dateYYYY-MM-DD. Default: latest completed session
from / toYYYY-MM-DD date range (interval=1day only)

Example Response

[{
  "symbol": "SPY",
  "open": 762.27,
  "high": 763.06,
  "low": 762.00,
  "close": 762.63,
  "volume": 8497,
  "interval": "1min",
  "timestamp": "2026-10-26T13:30:00-04:00"
}]
GET
/v1/eod

End-of-Day Prices

Daily OHLCV prices for roughly the last 100 sessions, newest first.

Parameters

symbol
required
Ticker symbol

Example Response

[{
  "symbol": "SPY",
  "date": "2026-10-26",
  "open": 762.25,
  "high": 767.73,
  "low": 761.63,
  "close": 765.37,
  "adjClose": null,
  "volume": 31651600
}]
GET
/v1/fundamentals

Company Fundamentals

Get company profile, financials, and key metrics.

Parameters

symbol
required
Ticker symbol

Example Response

{
  "symbol": "AAPL",
  "companyName": "Apple Inc.",
  "sector": "Technology",
  "marketCap": 3800000000000,
  "peRatio": 32.5,
  "eps": 6.57
}
GET
/v1/earnings

Earnings

Earnings reports with EPS estimates and actuals.

Parameters

symbol
required
Ticker symbol

Example Response

[{
  "symbol": "AAPL",
  "reportDate": "2026-07-24",
  "fiscalQuarter": "Q3 2026",
  "estimatedEps": 1.35,
  "actualEps": 1.42
}]
GET
/v1/dividends

Dividends

Dividend history with ex-dates and payment amounts.

Parameters

symbol
required
Ticker symbol

Example Response

[{
  "symbol": "AAPL",
  "exDate": "2026-08-09",
  "amount": 0.25,
  "frequency": "quarterly"
}]
GET
/v1/news

Market News

Financial news with sentiment and related tickers.

Parameters

symbolFilter by ticker symbol
categoryFilter: earnings, mergers, macro, etc.

Example Response

[{
  "headline": "Apple Reports Record Revenue",
  "summary": "Apple exceeded expectations...",
  "source": "Reuters",
  "symbols": ["AAPL"],
  "sentiment": "positive"
}]
GET
/v1/crypto

Crypto Quotes

Cryptocurrency price quotes.

Parameters

symbolCrypto symbol (e.g. BTC, ETH)

Example Response

{
  "symbol": "BTC",
  "pair": "BTC/USD",
  "price": 68432.50,
  "change": 1250.00,
  "changePct": 1.86
}
GET
/v1/forex

Forex Quotes

Foreign exchange rate quotes.

Parameters

pairCurrency pair (e.g. EUR/USD)

Example Response

{
  "pair": "EUR/USD",
  "bid": 1.0842,
  "ask": 1.0844,
  "mid": 1.0843
}

Try It