Marketdata App Market Data API

Name: Market Data API
Brand: Market Data API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentFinanceBankingapiKey14 EndpointsREST

For Agents

Pull real-time and historical US stock quotes, options chains, candle bars, earnings, and news through 14 endpoints. Authentication is an API key in the `token` query parameter.

Install Jentic One Beta

Connect the Market Data API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Market Data API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Market Data API.

Pull a real-time quote for a stock symbol via /v1/stocks/quotes/{symbol}/ or many symbols at once via /v1/stocks/bulkquotes/

Read historical candle bars at any resolution from /v1/stocks/candles/{resolution}/{symbol}/ or in bulk via /v1/stocks/bulkcandles/{resolution}/

Fetch the upcoming and historical earnings calendar for a symbol via /v1/stocks/earnings/{symbol}/

GET STARTED

Start building with Market Data API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Market Data API for, with concrete tasks.

★ Real-Time Watchlist Quotes

Trading dashboards and Slack bots call /v1/stocks/bulkquotes/ on a polling interval to refresh prices for a user's watchlist in a single round trip rather than one HTTP call per symbol. The response includes bid, ask, last, and volume so a UI can render full ticker rows. Polling integration is straightforward in a few hours.

Call /v1/stocks/bulkquotes/ with the symbols AAPL, MSFT, NVDA, AMZN, TSLA and return a JSON map of symbol to last price.

Options Chain Discovery

Options-focused tools call /v1/options/expirations/{underlying}/ and /v1/options/chain/{underlying}/ to load the full chain for an underlying and let traders pick a strike and expiry. The /v1/options/lookup/{userInput}/ endpoint resolves a free-form input like 'AAPL Sep 15 2025 200 call' into the canonical option symbol that /v1/options/quotes/{optionSymbol}/ accepts.

Call /v1/options/expirations/AAPL/ for the next available expiry, then /v1/options/chain/AAPL/ for that expiry and return only the call options with strikes within 5% of spot.

Back-Testing Candle Pulls

Quant research notebooks call /v1/stocks/candles/{resolution}/{symbol}/ at daily resolution to pull multi-year candle history for back-testing strategies on a single name. /v1/stocks/bulkcandles/{resolution}/ returns the same data across many symbols in one call, which is faster and cheaper for portfolio-level studies.

Call /v1/stocks/candles/D/SPY/ for a one-year window and return a list of dictionaries with date, open, high, low, close, and volume.

Earnings and News Aggregator

Market-news products call /v1/stocks/earnings/{symbol}/ to surface upcoming earnings dates and /v1/stocks/news/{symbol}/ to pull recent headlines for a watchlist. Combined they power an at-a-glance card per symbol showing the next earnings event and the latest two or three news items.

Call /v1/stocks/earnings/MSFT/ and /v1/stocks/news/MSFT/ in parallel and return a single JSON document with the next earnings date and the three most recent headlines.

AI Agent for Trading and Research

An AI research assistant calls Market Data through Jentic to answer quote, candle, options-chain, and earnings questions without bespoke client code. Jentic exposes each endpoint as a typed tool with a discoverable input schema so the agent picks /v1/stocks/quotes vs /v1/options/chain based on the user's question. Setup runs through search, load, and execute in under an hour.

Search Jentic for 'get a real-time stock quote', load the schema for /v1/stocks/quotes/{symbol}/, and execute the call for symbol NVDA.

Key Endpoints

14 endpoints — market data is a real-time and historical us equities and options data api.

METHOD

PATH

DESCRIPTION

GET

/v1/stocks/quotes/{symbol}/

Real-time quote for a single stock

GET

/v1/stocks/bulkquotes/

Bulk quotes for many symbols

GET

/v1/stocks/candles/{resolution}/{symbol}/

Historical candle bars for one symbol

GET

/v1/stocks/earnings/{symbol}/

Earnings calendar for a symbol

GET

/v1/stocks/news/{symbol}/

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Market Data API tokens are stored encrypted in the Jentic vault (MAXsystem) and injected into the `?token=` query parameter at execution time so the agent's prompt never holds the raw key. Tokens can be rotated in the vault without redeploying any agent code.

Intent-based discovery

Agents search Jentic by intent (e.g. 'real-time stock quote' or 'options chain for an underlying') and Jentic returns the matching Market Data operations with input schemas, so the agent picks the right /v1/stocks vs /v1/options endpoint without reading marketdata.app docs.

Time to first call

Direct integration: half a day for quotes plus options chain plus error handling. Through Jentic: under an hour from search to first successful call.

FAQs

Specific to using Market Data API through Jentic.

What authentication does the Market Data API use?

Market Data uses an API key passed as the `token` query parameter on every request. Jentic stores the key encrypted in the MAXsystem vault and appends it at execution time so the raw token never enters the agent context.

Can I pull intraday 1-minute candles for a stock?

Yes. GET /v1/stocks/candles/{resolution}/{symbol}/ accepts the resolution as a path parameter — `1` returns 1-minute bars, `D` returns daily bars, and so on. Use /v1/stocks/bulkcandles/{resolution}/ to pull the same resolution across many symbols in one call.

Does Market Data offer options data?

Yes. The /v1/options/chain/{underlying}/, /v1/options/expirations/{underlying}/, /v1/options/strikes/{underlying}/, /v1/options/lookup/{userInput}/, and /v1/options/quotes/{optionSymbol}/ endpoints together cover chain discovery and per-option quoting.

What are the rate limits for the Market Data API?

Rate limits are tier-based and not declared in the spec. Each plan exposes a daily request budget visible on the marketdata.app dashboard; over-quota requests return HTTP 429 so callers should respect the response code and back off.

How do I get a real-time stock quote through Jentic?

Run `pip install jentic`, search for 'get a real-time stock quote', load the schema for GET /v1/stocks/quotes/{symbol}/, and execute it with the desired symbol. Jentic supplies the API key and returns parsed JSON.

How do I check whether the US market is open before placing trades?

GET /v1/markets/status/ returns the current open/closed status of supported markets. Call it before kicking off any quote or order workflow so a research notebook does not interpret a stale closing price as live.