ValueRay Developer API

AI-Ready Data API for Stocks & ETFs | ValueRay

Power Your AI with Context-Aware Financial Data.

Access structured investment research, peer comparisons, risk metrics and market context through a REST API designed for applications, quantitative workflows and AI agents.

Create Free Account View OpenAPI Schema

Free access is available. Every authenticated request uses the same Bearer token.

Example API request

curl "https://www2d.valueray.com/api/v1/symbolData?symbol=AAPL" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

AI and agent discovery

Machine-readable entry points

Use these resources to inspect the API, discover the MCP server or provide an agent with ValueRay field definitions and scoring logic.

Open API Specification

llms.txt


                                    /llms.txt

AI-readable overview with the main ValueRay entry points.

Open resource →

Agent Authentication


                                    /auth.md

Authentication instructions for agents using manually registered OAuth clients.

Open resource →

OAuth Discovery


                                    /.well-known/oauth-authorization-server

OAuth 2.0 authorization server metadata for automatic endpoint discovery.

Open resource →

Protected Resource


                                    /.well-known/oauth-protected-resource

OAuth metadata connecting the ValueRay MCP API to its authorization server.

Open resource →

MCP Discovery


                                    /.well-known/mcp.json

Machine-readable metadata for compatible MCP clients.

Open resource →

MCP Server Card


                                    /.well-known/mcp/server-card.json

Machine-readable MCP server identity, transport and capability metadata.

Open resource →

Authentication

Use one Bearer token for every request

Your API token is a standardized Bearer token and is sent in the Authorization header according to RFC 6750.

Create Free Account

Create or reset your token

Manage the token from your ValueRay profile.

Add the authorization header


                                    Authorization: Bearer 123|vr_abcdef123456

Send the request

Request JSON from any endpoint using the same header and your active usage limits.

Available endpoints

Structured research without assembling multiple data sources

Each endpoint returns analysis-ready JSON with explicit usage limits and a directly executable example.

REST API

Symbol Search

FREE · 50 req/min


                                    /api/v1/symbolSearch

Resolve a company name, ticker, ISIN or plain-language description to the exact identifiers ValueRay understands. Results include ranked symbols, names, exchanges and ISINs.

Try Example

Why it matters The entry point for every workflow

Convert imperfect human input into a verified symbol before requesting research data. This prevents guessed tickers and malformed downstream requests.

REST API

Symbol Technical Overview

FREE · 50 req/day


                                    /api/v1/symbolData

Retrieve the complete technical, quantitative and market context for a symbol in one request, including price action, trends, support and resistance, risk metrics, performance, peer percentiles, dividends, sector rotation and proprietary signals.

Try Example

Why it matters One call, full research context

Replace a fragmented data pipeline with one structured response that is ready for analysis by applications, agents and language models.

REST API

Symbol Peers

FREE · 50 req/day


                                    /api/v1/symbolPeers

Compare a stock or ETF with its closest GICS sub-industry peers. The response includes percentile rankings across performance, valuation, profitability, debt and risk metrics.

Try Example

Why it matters Turn raw metrics into context

A valuation or profitability metric becomes more useful when it is ranked against the correct peer group instead of interpreted in isolation.

REST API

Market Regime & Rotation

FREE · 50 req/day


                                    /api/v1/marketRegime

Retrieve the current market regime, sector rotation scores and breadth indicators. The dataset updates end-of-day, so repeated intraday polling does not produce new observations.

Try Example

Why it matters Evaluate the market before the symbol

Regime, volatility, breadth, credit and sector rotation show whether the broader environment supports or contradicts an individual setup.

Start building

Bring structured investment research into your application.

Create a token, inspect the schema and run your first ValueRay API request.

Create Free Account View OpenAPI Schema