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
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

Connect your account and start requesting data

Your API token is a standardized Bearer token and is sent in the Authorization header according to RFC 6750. /api/account also accepts an optional browser session.

Create Free Account
1

Create or reset your token

Manage the token from your ValueRay profile.

2

Add the authorization header

Authorization: Bearer 123|vr_abcdef123456
3

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.

00
REST API

Account & Usage

FREE · 0 credits
/api/account

See whether API access is available for the current user and get the account information that matters for a workflow, including roles, subscription status and remaining API calls.

Try Example uses your browser session, if signed in, and does not add a Bearer token.

Try Example
Why it matters Check access without spending a credit

Confirm API access and remaining capacity before requesting market data. The check itself does not consume API credits.

01
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.

02
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.

03
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.

04
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