How does an AI agent get access to the Stock Market API?

Create a free API key with a single POST to /api/v1/auth/keys (email only, no card) and send it as an X-API-Key header on every request.

What should I feed my agent so it knows the endpoints?

Three options, most-compact first: llms.txt (site and API map), skill.md (usage patterns and conventions for coding agents), llms-full.txt (every endpoint with parameters, generated from the OpenAPI schema).

Can an agent pay for a subscription without a human?

Yes — POST /payments/agent-subscribe implements the x402 protocol: the agent signs a gasless EIP-712 USDC authorization on Base and receives a Pro API key in two HTTP calls.

Is the data machine-readable?

Everything is JSON with per-field source tags and completeness metadata, plus annual-report PDFs converted to markdown for LLM consumption.

--:--:--LOCAL ·--:--UTC

US EQUITIESLAST CLOSE

AAPL$333.86+0.05%

MSFT$526.22+1.68%

GOOGL$344.79+0.37%

AMZN$251.62+0.04%

NVDA$236.88+1.25%

META$740.87+1.76%

TSLA$378.74+2.20%

NFLX$66.90-0.23%

BRK.B$504.30+0.33%

AVGO$358.57+0.96%

DIS$102.42+0.22%

SBUX$93.90-0.86%

MCD$229.82-0.89%

NKE$32.82-3.10%

COST$916.52-0.45%

WMT$103.74-0.50%

HD$281.43-0.50%

KO$85.86+0.25%

PG$145.40+0.34%

ORCL$145.47+2.23%

CRM$231.18-1.50%

ADBE$238.55+0.36%

AMD$629.19-0.74%

INTC$116.86-2.07%

QCOM$182.75-1.15%

CSCO$112.21+0.01%

IBM$221.70-0.42%

UBER$69.46+1.98%

ABNB$163.02+0.36%

SHOP$157.26+3.87%

PYPL$53.68+1.67%

COIN$191.38+4.58%

PLTR$188.96+0.11%

HOOD$115.25+2.22%

JPM$332.29-0.03%

V$364.98+1.20%

MA$560.91+1.57%

BAC$54.08+0.61%

GS$893.48-1.01%

LLY$1156.91+1.23%

UNH$371.61-0.08%

JNJ$254.52-0.59%

PFE$27.43-1.31%

XOM$162.90-0.68%

BA$193.41-0.08%

BABA$108.75+2.74%

TSM$477.18+0.93%

US EQUITIESLAST CLOSE

AAPL$333.86+0.05%

MSFT$526.22+1.68%

GOOGL$344.79+0.37%

AMZN$251.62+0.04%

NVDA$236.88+1.25%

META$740.87+1.76%

TSLA$378.74+2.20%

NFLX$66.90-0.23%

BRK.B$504.30+0.33%

AVGO$358.57+0.96%

DIS$102.42+0.22%

SBUX$93.90-0.86%

MCD$229.82-0.89%

NKE$32.82-3.10%

COST$916.52-0.45%

WMT$103.74-0.50%

HD$281.43-0.50%

KO$85.86+0.25%

PG$145.40+0.34%

ORCL$145.47+2.23%

CRM$231.18-1.50%

ADBE$238.55+0.36%

AMD$629.19-0.74%

INTC$116.86-2.07%

QCOM$182.75-1.15%

CSCO$112.21+0.01%

IBM$221.70-0.42%

UBER$69.46+1.98%

ABNB$163.02+0.36%

SHOP$157.26+3.87%

PYPL$53.68+1.67%

COIN$191.38+4.58%

PLTR$188.96+0.11%

HOOD$115.25+2.22%

JPM$332.29-0.03%

V$364.98+1.20%

MA$560.91+1.57%

BAC$54.08+0.61%

GS$893.48-1.01%

LLY$1156.91+1.23%

UNH$371.61-0.08%

JNJ$254.52-0.59%

PFE$27.43-1.31%

XOM$162.90-0.68%

BA$193.41-0.08%

BABA$108.75+2.74%

TSM$477.18+0.93%

StockMarketAPI

Get API Key

Plug stock market data into your AI agent — one command: Get your free API key →

StockMarketAPI

AmericasNYSE NASDAQ TSXEuropeLSE EuronextAsia-PacificTSE HKEX ASX All exchanges →

United StatesS&P 500 NASDAQ-100 Dow Jones 30InternationalS&P/ASX 200 FTSE 100 Nikkei 225 All indices →

Covered Companies Reporting Calendar ASX 200 Coverage

AI Agent Quickstart Agent Skill API Docs OpenAPI JSON LLMs.txt AI Agent Pricing

Pricing →

Quick start for AI agents

Wire your agent into the Stock Market API

Free API key in one call, machine-readable discovery files, and setup snippets for the agents people actually run. Agents on paid work can even subscribe themselves with USDC.

Point your agent at the API

Three discovery files, most-compact first — feed whichever fits your agent's context budget:

llms.txt

The site and API map (llmstxt.org format): exchanges, indices, key endpoints, auth. Best default for chat agents.

skill.md

Usage patterns, code examples and conventions for coding agents — installable as a Claude Code skill.

llms-full.txt

Every endpoint with parameters, generated from the OpenAPI spec. For agents that plan multi-step queries.

Get a key, make a call

# 1. Create a free API key
curl -X POST https://stockmarketapi.ai/api/v1/auth/keys \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}'

# 2. Call any endpoint with the key
curl -H "X-API-Key: YOUR_KEY" \
  https://stockmarketapi.ai/api/v1/companies/AAPL/financials

Per-agent setup

Claude Code

Install the skill file — Claude Code then knows every endpoint, auth flow, and convention.

mkdir -p .claude/skills/stockmarket-api
curl -o .claude/skills/stockmarket-api/SKILL.md https://stockmarketapi.ai/skill.md

Claude Desktop

Add the skill file (or llms.txt) to a Project's knowledge; Claude uses the documented REST endpoints directly.

1. Download https://stockmarketapi.ai/skill.md
2. Claude Desktop → Projects → your project → Add to project knowledge
3. Ask: "Get AAPL's latest financials from the Stock Market API"

Cursor

Index the llms.txt map as docs so Cursor autocompletes against real endpoints.

Cursor → Settings → Features → Docs → Add
URL: https://stockmarketapi.ai/llms.txt
Then reference @StockMarketAPI in chat.

OpenAI Codex CLI

Point AGENTS.md at the full endpoint reference; Codex reads it before calling the API.

# AGENTS.md
Stock market data: use the REST API described at https://stockmarketapi.ai/llms-full.txt
Auth: X-API-Key header (free keys via POST /api/v1/auth/keys).

Gemini CLI

Point GEMINI.md at the endpoint reference the same way.

# GEMINI.md
Stock market data: use the REST API described at https://stockmarketapi.ai/llms-full.txt
Auth: X-API-Key header (free keys via POST /api/v1/auth/keys).

Agentic payments (x402)

An agent that needs paid-tier data does not have to stop and ask a human for a credit card. The x402 flow settles a gasless USDC payment on Base and returns a Pro API key — two HTTP calls, no browser.

# Agents upgrade themselves: gasless USDC (Base) via x402
POST https://stockmarketapi.ai/payments/agent-subscribe
# 402 response lists payment requirements → sign EIP-712 → resend
# Two HTTP calls total; returns a Pro API key.
# Machine-readable pricing: GET https://stockmarketapi.ai/api/v1/agentic/routes

Full API documentation

Interactive Swagger UI over every endpoint on this page.

API Docs Pricing

Frequently Asked Questions

How does an AI agent get access to the Stock Market API?: Create a free API key with a single POST to /api/v1/auth/keys (email only, no card) and send it as an X-API-Key header on every request.
What should I feed my agent so it knows the endpoints?: Three options, most-compact first: llms.txt (site and API map), skill.md (usage patterns and conventions for coding agents), llms-full.txt (every endpoint with parameters, generated from the OpenAPI schema).
Can an agent pay for a subscription without a human?: Yes — POST /payments/agent-subscribe implements the x402 protocol: the agent signs a gasless EIP-712 USDC authorization on Base and receives a Pro API key in two HTTP calls.
Is the data machine-readable?: Everything is JSON with per-field source tags and completeness metadata, plus annual-report PDFs converted to markdown for LLM consumption.