FinanceActive

Stock Price Lookup

Real-time stock data via Yahoo Finance. Returns price, change, change_pct, previous_close, market_cap, pe_ratio, week_52_high, week_52_low, volume, and market_state. Max 10 symbols per call. Non-US exchange suffixes: 'SAP.DE' (Xetra), 'VOD.L' (London LSE), 'AIR.PA' (Paris Euronext), 'ASML.AS' (Amsterdam).

Endpointx402 Payment Required

POST

https://agentsvc.io/api/v1/proxy/stock-prices

Price

$0.002 USDC

Latency P99

~800ms

Provider

agentsvc.io

Input Schema

{ "type": "object", "required": [ "symbols" ], "properties": { "symbols": { "type": "array", "items": { "type": "string" }, "description": "List of stock ticker symbols. Max 10 per call. Examples: ['AAPL', 'MSFT', 'NVDA'] for US stocks, ['SAP.DE', 'BAYN.DE'] for German XETRA stocks, ['TSLA', 'GOOGL', 'AMZN']. Use the exchange suffix for non-US stocks (e.g. .DE, .L, .PA)." } } }

Output Schema

{ "type": "object", "required": [ "stocks", "fetched_at" ], "properties": { "stocks": { "type": "object", "description": "Map of ticker symbol → stock data", "additionalProperties": { "type": "object", "properties": { "symbol": { "type": "string", "description": "Ticker symbol as provided" }, "name": { "type": "string", "description": "Full company name (e.g. 'Apple Inc.')" }, "exchange": { "type": "string", "description": "Exchange name (e.g. 'NMS', 'NYQ', 'GER')" }, "currency": { "type": "string", "description": "Trading currency (e.g. 'USD', 'EUR', 'GBP')" }, "price": { "type": "number", "description": "Current market price" }, "change": { "type": "number", "description": "Price change vs previous close" }, "change_pct": { "type": "number", "description": "Price change in percent (e.g. 1.23 means +1.23%)" }, "previous_close": { "type": "number", "description": "Previous trading day closing price" }, "open": { "type": "number", "description": "Today's opening price" }, "day_high": { "type": "number", "description": "Today's intraday high" }, "day_low": { "type": "number", "description": "Today's intraday low" }, "volume": { "type": "integer", "description": "Today's trading volume (shares)" }, "market_cap": { "type": "number", "description": "Market capitalization in the stock's currency" }, "pe_ratio": { "type": "number", "description": "Trailing P/E ratio (price-to-earnings)" }, "week_52_high": { "type": "number", "description": "52-week price high" }, "week_52_low": { "type": "number", "description": "52-week price low" }, "market_state": { "type": "string", "description": "Market state: 'REGULAR', 'PRE', 'POST', 'CLOSED'" } } } }, "not_found": { "type": "array", "items": { "type": "string" }, "description": "Symbols that could not be resolved" }, "fetched_at": { "type": "string", "format": "date-time", "description": "ISO 8601 timestamp" }, "source": { "type": "string", "description": "Always: 'Yahoo Finance'" } }, "example": { "stocks": { "AAPL": { "symbol": "AAPL", "name": "Apple Inc.", "exchange": "NMS", "currency": "USD", "price": 260.49, "change": 1.59, "change_pct": 0.61, "previous_close": 258.9, "open": 259.5, "day_high": 261.2, "day_low": 258.75, "volume": 48200000, "market_cap": 3910000000000, "pe_ratio": 32.4, "week_52_high": 273.59, "week_52_low": 169.21, "market_state": "REGULAR" }, "MSFT": { "symbol": "MSFT", "name": "Microsoft Corporation", "exchange": "NMS", "currency": "USD", "price": 373.07, "change": 1.43, "change_pct": 0.38, "previous_close": 371.64, "market_state": "REGULAR" } }, "not_found": [], "fetched_at": "2026-04-10T14:00:00.000Z", "source": "Yahoo Finance" } }

Code Examples

# Step 1: Call without payment → receive 402 with requirements
curl -X POST "https://agentsvc.io/api/v1/proxy/stock-prices" \
  -H "Content-Type: application/json" \
  -d '{}'

# Step 2: Sign payment using x402 SDK, then retry
curl -X POST "https://agentsvc.io/api/v1/proxy/stock-prices" \
  -H "Content-Type: application/json" \
  -H "X-Payment: x402 usdc base <your-signed-payment>" \
  -d '{}'

Tags

#stocks#finance#nasdaq#nyse#shares#market#trading#equities

Service Info

Service IDsvc_stocks_17
Categoryfinance
StatusActive
ChainBase (USDC)
Protocolx402
Read API Documentation →