AI-Ready Data API for Stocks & ETFs | ValueRay

Power Your AI with Context-Aware Financial Data.

AI / Agent Discovery

Investment intelligence built for AI, Investors and Analysts: one call returns all the full research context an AI model needs.

llms.txt - AI-readable overview and agent entry points.
MCP Discovery - Machine-readable MCP server metadata.
MCP Server - Streamable HTTP endpoint for MCP clients.
OpenAPI Specification - Canonical machine-readable API schema.
API Metadata - API catalog metadata for discovery tools.
Field definitions and scoring logic - Methodology, metric definitions and interpretation guide for API and MCP output.

How to use your API Token

Your API token is also called a Bearer token — the same thing. It is the widely used, standardized way (RFC 6750) to authenticate a request and is sent in the Authorization header of every call:

Authorization: Bearer 123|vr_abcdef123456

Create or reset your token on your profile page. A developer-friendly guide with examples is in the Swagger Bearer Authentication docs.

Symbol Search FREE · 50 req/min

/api/v1/symbolSearch

Resolve any company, ticker, ISIN or plain-language description to the exact symbol codes ValueRay understands. One call returns ranked suggestions with code, name, exchange and ISIN — the lookup layer that turns "apple" or "US0378331005" into the AAPL identifier every other endpoint expects.

Try Example

The entry point for everything

Every other call needs a symbol code first. This endpoint maps messy human input — names, tickers, ISINs — onto the precise identifier, so an agent never guesses a ticker or sends a malformed request downstream.

Symbol Technical Overview FREE · 50 req/day

/api/v1/symbolData

Everything you need to judge a stock in one request — no stitching together ten data sources. One call returns the complete technical, quantitative and sentiment picture an analyst or AI model needs: price action, moving averages, support and resistance, risk metrics (beta, Sharpe, drawdowns), multi-horizon performance, peer percentiles, dividends, sector rotation and proprietary buy signals.

Try Example

One call, full context

Replace a whole data pipeline with a single endpoint. Everything an LLM needs to reason about a stock arrives pre-computed and structured — no feature engineering, no joins, no missing fields.

Symbol Peers FREE · 50 req/day

/api/v1/symbolPeers

Peer comparison within GICS sub-industry groups. Returns percentile rankings across performance, valuation, profitability, debt and risk metrics — showing where a stock or ETF stands relative to its closest peers.

Try Example

Context, not just numbers

A P/E of 30 means nothing alone. Percentile rankings against the real peer group turn raw metrics into judgement — instantly answering "is this expensive, profitable, risky for its class?"

Market Regime & Rotation FREE · 50 req/day

/api/v1/marketRegime

Current market regime, sector rotation scores and breadth indicators. Data updates end-of-day — polling more frequently won't yield new results.

Try Example

Know the weather first

The same signal means different things in different regimes. VIX, breadth, credit and rotation in one read tell you whether the market is risk-on or risk-off before you act on any single stock.

Connect with ChatGPT

Building MCP servers for ChatGPT
Settings → Apps → Advanced settings → Activate Developer Mode
Settings → Apps → Advanced settings → Add App (Custom MCP server)
No-Auth: for limited Free-Access:

Name: ValueRay
URL: https://www.valueray.com/mcp/api

Oauth: to use your API-Calls or Subscriptiosn

Create your Credentials with your indiviuell Callback-URL from ChatGP (https://chatgpt.com/connector/oauth/...)
Fill in your Client ID and Client Secret
Auth URL: https://www.valueray.com/oauth/authorize
Token URL: https://www.valueray.com/oauth/token
Confirm and create