{ "openapi": "3.1.0", "x-zeroclick-navigation": { "fullSpec": "https://agents.x402stock.xyz/zcj/jobosa66czb2/openapi.json", "services": "https://agents.x402stock.xyz/zcj/jobosa66czb2/services", "serviceSpecTemplate": "https://agents.x402stock.xyz/zcj/jobosa66czb2/services/{slug}/openapi.json", "searchTemplate": "https://agents.x402stock.xyz/zcj/jobosa66czb2/openapi.json?q={text}", "operationTemplate": "https://agents.x402stock.xyz/zcj/jobosa66czb2/openapi.json?path={path}&method={method}", "firstPage": "https://agents.x402stock.xyz/zcj/jobosa66czb2/openapi.json?page=1", "instructions": [ "Use this spec if it contains the operation and details you need. Otherwise, search or open a relevant service spec using the links below.", "Find service slugs in x-zeroclick-services or x-payment-info.rates[].service; use them in serviceSpecTemplate, never as request values.", "URL-encode template values. Search is ranked; service, path, and method filters are exact. Filters combine.", "Pages contain up to 10 operations; follow info.x-next or the Link header if you need more results. Shared operations retain all selector values." ] }, "info": { "title": "x402stock", "version": "1.0.0", "description": "Market and economic data for AI agents — US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities (crude, natural gas, gasoline), US and global macro (Fed funds, CPI/PCE, jobs, GDP, Treasury debt & yields, World Bank indicators), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 or MPP. This server is a pay-per-use, transparent proxy in front of x402stock's own API: it handles identity, payment, and proxying. Agents can purchase autonomously or with their human's approval. The complete verified paid surface is listed at /openapi.json, the source of truth for available operations. Each operation here carries its live price in x-payment-info. Use the operations and details here when they meet your needs. Filtered specs contain only matching operations; if you cannot find what you need here, use search or the service catalog. The live catalog at /manifest.json is authoritative for prices and any free included units (prices[].includedUnits) - some meters include free usage per account before any charge, reserved for agents claimed by a human with a verified email.", "contact": { "email": "parthnandaniya@gmail.com" }, "x-guidance": "This is a filtered API reference. Request and response schemas are preserved. Shared operations retain selector values and prices for all their services; service slugs are pricing labels, never request values. If this spec lacks what you need, use the navigation links to search or open a relevant service spec." }, "x-service-info": { "categories": [ "data" ], "docs": { "homepage": "https://x402stock.xyz", "apiReference": "https://agents.x402stock.xyz/zcj/jobosa66czb2/openapi.json", "llms": "https://agents.x402stock.xyz/zcj/jobosa66czb2/llms.txt" } }, "externalDocs": { "url": "https://agents.x402stock.xyz/zcj/jobosa66czb2/llms-full.txt", "description": "How to authenticate, pay, and call this API; links the upstream API reference." }, "servers": [ { "url": "https://agents.x402stock.xyz/zcj/jobosa66czb2", "description": "Pay-per-use access to x402stock's API" } ], "security": [ { "payPerUse": [] } ], "components": { "securitySchemes": { "payPerUse": { "type": "apiKey", "in": "header", "name": "x-payment", "description": "Pay-per-use access. An unpaid call returns 402 Payment Required with a signed challenge; settle it with a supported payment method (x402 or MPP today) and retry with the proof in this header (x402) or as an authorization bearer credential (MPP). No upstream API key is needed, and an agent without a payment method can set one up instantly at no cost." } } }, "paths": { "/api/v1/aggregates/{ticker}": { "get": { "x-zeroclick-services": [ "stock-quotes" ], "summary": "The stock price history endpoint. Returns historical OHLCV bars at the requested multiplier and timespan (minute, hour, day, week, month) between `from` and `to`. Use for price history, charting, backtesting, and trend analysis over any date range. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.", "parameters": [ { "in": "path", "name": "ticker", "schema": { "type": "string" }, "example": "AAPL", "required": true, "description": "US-listed ticker symbol (uppercase), e.g. AAPL." }, { "in": "query", "name": "multiplier", "schema": { "type": "integer", "default": 1, "maximum": 50000, "exclusiveMinimum": 0 } }, { "in": "query", "name": "timespan", "schema": { "enum": [ "minute", "hour", "day", "week", "month", "quarter", "year" ], "type": "string", "default": "day" } }, { "in": "query", "name": "from", "schema": { "type": "string", "default": "2025-07-31", "minLength": 1 } }, { "in": "query", "name": "to", "schema": { "type": "string", "default": "2026-07-31", "minLength": 1 } }, { "in": "query", "name": "adjusted", "schema": { "type": "boolean", "default": true } }, { "in": "query", "name": "sort", "schema": { "enum": [ "asc", "desc" ], "type": "string", "default": "asc" } }, { "in": "query", "name": "limit", "schema": { "type": "integer", "default": 5000, "maximum": 50000, "exclusiveMinimum": 0 } } ], "x-payment-info": { "protocols": [ { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } }, { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } } ], "offers": [ { "amount": "20000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "$0.020000 per request (aggregates, service stock-quotes)", "intent": "charge", "method": "tempo" } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "rates": [ { "service": "stock-quotes", "meter": "aggregates", "unit": "request", "unitSize": 1, "priceUsd": "0.020000", "includedUnits": 0 } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "ticker", "data", "source", "as_of" ], "properties": { "data": { "type": "object", "required": [ "bars", "count" ], "properties": { "bars": { "type": "array", "items": { "type": "object", "required": [ "open", "high", "low", "close", "volume", "vwap", "trade_count", "timestamp" ], "properties": { "low": { "type": "number" }, "high": { "type": "number" }, "open": { "type": "number" }, "vwap": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "close": { "type": "number" }, "volume": { "type": "number" }, "timestamp": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "trade_count": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "additionalProperties": false } }, "count": { "type": "number" }, "adjusted": { "type": "boolean" } }, "additionalProperties": false }, "as_of": { "type": "string" }, "source": { "type": "string", "const": "x402stock" }, "ticker": { "type": "string" }, "feedback": { "type": "object", "required": [ "endpoint", "method", "free", "note" ], "properties": { "free": { "type": "boolean" }, "note": { "type": "string" }, "method": { "type": "string", "const": "POST" }, "endpoint": { "type": "string" } }, "additionalProperties": false } }, "additionalProperties": false } } } }, "402": { "description": "Payment required" } } } }, "/api/v1/basis": { "get": { "x-zeroclick-services": [ "stock-quotes" ], "summary": "Scans every US stock that also trades as a 24/7 synthetic perp and returns the gap: official (delayed) price, prev close, perp mark and oracle, funding APR, open interest, and computed `basis_percent` + `basis_vs_prev_close_percent` — the implied overnight move while the US market is shut. Widest dislocation first, plus a plain-English `reading`. `?limit=`, `?min_basis=`. From x402stock", "parameters": [ { "in": "query", "name": "min_basis", "schema": { "type": "number", "default": 0, "maximum": 100, "minimum": 0 } }, { "in": "query", "name": "limit", "schema": { "type": "integer", "default": 40, "maximum": 200, "exclusiveMinimum": 0 } } ], "x-payment-info": { "protocols": [ { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } }, { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } } ], "offers": [ { "amount": "50000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "$0.050000 per request (basis, service stock-quotes)", "intent": "charge", "method": "tempo" } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "rates": [ { "service": "stock-quotes", "meter": "basis", "unit": "request", "unitSize": 1, "priceUsd": "0.050000", "includedUnits": 0 } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "source", "as_of", "venue_map", "us_market_open", "reading", "method", "count", "rows", "sections", "note", "total_available" ], "properties": { "note": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "rows": { "type": "array", "items": { "type": "object", "required": [ "ticker", "equity_price", "equity_prev_close", "equity_change_percent", "equity_as_of", "perp_symbol", "perp_mark", "perp_oracle", "perp_funding_apr_percent", "perp_open_interest", "perp_day_volume_usd", "basis_percent", "basis_absolute", "basis_vs_prev_close_percent", "direction", "comparable", "excluded_reason" ], "properties": { "ticker": { "type": "string" }, "direction": { "enum": [ "premium", "discount", "flat", "unknown" ], "type": "string" }, "perp_mark": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "comparable": { "type": "boolean" }, "perp_oracle": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "perp_symbol": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "equity_as_of": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "equity_price": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "basis_percent": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "basis_absolute": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "excluded_reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "equity_prev_close": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "perp_open_interest": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "perp_day_volume_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "equity_change_percent": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "perp_funding_apr_percent": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "basis_vs_prev_close_percent": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "additionalProperties": false } }, "as_of": { "type": "string" }, "count": { "type": "number" }, "method": { "type": "string" }, "source": { "type": "string", "const": "x402stock" }, "reading": { "type": "string" }, "sections": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "enum": [ "ok", "unavailable" ], "type": "string" } }, "venue_map": { "type": "object", "required": [ "equity", "perp" ], "properties": { "perp": { "type": "string" }, "equity": { "type": "string" } }, "additionalProperties": false }, "us_market_open": { "type": "boolean" }, "total_available": { "type": "number" } }, "additionalProperties": false } } } }, "402": { "description": "Payment required" } } } }, "/api/v1/basis/{ticker}": { "get": { "x-zeroclick-services": [ "stock-quotes" ], "summary": "One stock priced on every rail at once: its official US listing (delayed, closed overnight) against the 24/7 Hyperliquid HIP-3 synthetic perp. Returns both prices, funding APR, open interest, and the gap as `basis_percent` + `basis_vs_prev_close_percent` — while the US market is shut, the live view of where the name reopens. From x402stock, a market & economic data API (x402, USDC).", "parameters": [ { "in": "path", "name": "ticker", "schema": { "type": "string" }, "example": "AAPL", "required": true, "description": "US-listed ticker symbol (uppercase), e.g. AAPL." } ], "x-payment-info": { "protocols": [ { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } }, { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } } ], "offers": [ { "amount": "30000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "$0.030000 per request (basis_ticker, service stock-quotes)", "intent": "charge", "method": "tempo" } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.030000" }, "rates": [ { "service": "stock-quotes", "meter": "basis_ticker", "unit": "request", "unitSize": 1, "priceUsd": "0.030000", "includedUnits": 0 } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "source", "as_of", "venue_map", "us_market_open", "reading", "method", "count", "rows", "sections", "note" ], "properties": { "note": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "rows": { "type": "array", "items": { "type": "object", "required": [ "ticker", "equity_price", "equity_prev_close", "equity_change_percent", "equity_as_of", "perp_symbol", "perp_mark", "perp_oracle", "perp_funding_apr_percent", "perp_open_interest", "perp_day_volume_usd", "basis_percent", "basis_absolute", "basis_vs_prev_close_percent", "direction", "comparable", "excluded_reason" ], "properties": { "ticker": { "type": "string" }, "direction": { "enum": [ "premium", "discount", "flat", "unknown" ], "type": "string" }, "perp_mark": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "comparable": { "type": "boolean" }, "perp_oracle": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "perp_symbol": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "equity_as_of": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "equity_price": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "basis_percent": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "basis_absolute": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "excluded_reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "equity_prev_close": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "perp_open_interest": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "perp_day_volume_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "equity_change_percent": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "perp_funding_apr_percent": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "basis_vs_prev_close_percent": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "additionalProperties": false } }, "as_of": { "type": "string" }, "count": { "type": "number" }, "method": { "type": "string" }, "source": { "type": "string", "const": "x402stock" }, "reading": { "type": "string" }, "sections": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "enum": [ "ok", "unavailable" ], "type": "string" } }, "venue_map": { "type": "object", "required": [ "equity", "perp" ], "properties": { "perp": { "type": "string" }, "equity": { "type": "string" } }, "additionalProperties": false }, "us_market_open": { "type": "boolean" } }, "additionalProperties": false } } } }, "402": { "description": "Payment required" } } } }, "/api/v1/full-market-snapshot": { "get": { "x-zeroclick-services": [ "stock-quotes" ], "summary": "Current state of every US-listed ticker in a single call: price, day change and percent change, volume, and VWAP per symbol. The base layer for building a screener or scanning the whole market without iterating ticker by ticker. Optional `?tickers=AAPL,MSFT` to narrow and `?include_otc=true` to add OTC names. From x402stock, a market & economic data API (x402, USDC).", "parameters": [ { "in": "query", "name": "tickers", "schema": { "type": "string", "minLength": 1 } }, { "in": "query", "name": "include_otc", "schema": { "type": "boolean" } } ], "x-payment-info": { "protocols": [ { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } }, { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } } ], "offers": [ { "amount": "40000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "$0.040000 per request (full_market_snapshot, service stock-quotes)", "intent": "charge", "method": "tempo" } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.040000" }, "rates": [ { "service": "stock-quotes", "meter": "full_market_snapshot", "unit": "request", "unitSize": 1, "priceUsd": "0.040000", "includedUnits": 0 } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "source", "as_of", "count", "tickers" ], "properties": { "as_of": { "type": "string" }, "count": { "type": "number" }, "source": { "type": "string", "const": "x402stock" }, "tickers": { "type": "array", "items": { "type": "object", "required": [ "ticker", "price", "change", "change_percent", "volume", "vwap", "updated" ], "properties": { "vwap": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "price": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "change": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "ticker": { "type": "string" }, "volume": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "updated": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "change_percent": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "additionalProperties": false } } }, "additionalProperties": false } } } }, "402": { "description": "Payment required" } } } }, "/api/v1/gainers": { "get": { "x-zeroclick-services": [ "stock-quotes" ], "summary": "The day's biggest percentage gainers across US equities, with current and previous-day OHLCV per ticker. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.", "parameters": [ { "in": "query", "name": "limit", "schema": { "type": "integer", "maximum": 100, "exclusiveMinimum": 0 } } ], "x-payment-info": { "protocols": [ { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } }, { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } } ], "offers": [ { "amount": "20000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "$0.020000 per request (gainers, service stock-quotes)", "intent": "charge", "method": "tempo" } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "rates": [ { "service": "stock-quotes", "meter": "gainers", "unit": "request", "unitSize": 1, "priceUsd": "0.020000", "includedUnits": 0 } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "source", "as_of", "direction", "count", "tickers" ], "properties": { "as_of": { "type": "string" }, "count": { "type": "number" }, "source": { "type": "string", "const": "x402stock" }, "tickers": { "type": "array", "items": { "type": "object", "required": [ "ticker", "change", "change_percent", "updated" ], "properties": { "day": { "type": "object", "required": [ "open", "high", "low", "close", "volume", "vwap" ], "properties": { "low": { "type": "number" }, "high": { "type": "number" }, "open": { "type": "number" }, "vwap": { "type": "number" }, "close": { "type": "number" }, "volume": { "type": "number" } }, "additionalProperties": false }, "change": { "type": "number" }, "ticker": { "type": "string" }, "updated": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "previous_day": { "type": "object", "required": [ "open", "high", "low", "close", "volume", "vwap" ], "properties": { "low": { "type": "number" }, "high": { "type": "number" }, "open": { "type": "number" }, "vwap": { "type": "number" }, "close": { "type": "number" }, "volume": { "type": "number" } }, "additionalProperties": false }, "change_percent": { "type": "number" } }, "additionalProperties": false } }, "direction": { "enum": [ "gainers", "losers" ], "type": "string" } }, "additionalProperties": false } } } }, "402": { "description": "Payment required" } } } }, "/api/v1/grouped-daily": { "get": { "x-zeroclick-services": [ "stock-quotes" ], "summary": "End-of-day OHLCV bars for every US-listed ticker on a single date; one call returns the entire market. Pass `?date=YYYY-MM-DD` (required). From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.", "parameters": [ { "in": "query", "name": "date", "schema": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "required": true, "example": "sample" }, { "in": "query", "name": "adjusted", "schema": { "type": "boolean", "default": true } } ], "x-payment-info": { "protocols": [ { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } }, { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } } ], "offers": [ { "amount": "20000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "$0.020000 per request (grouped_daily, service stock-quotes)", "intent": "charge", "method": "tempo" } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "rates": [ { "service": "stock-quotes", "meter": "grouped_daily", "unit": "request", "unitSize": 1, "priceUsd": "0.020000", "includedUnits": 0 } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "source", "as_of", "date", "count", "results" ], "properties": { "date": { "type": "string" }, "as_of": { "type": "string" }, "count": { "type": "number" }, "source": { "type": "string", "const": "x402stock" }, "results": { "type": "array", "items": { "type": "object", "required": [ "ticker", "open", "high", "low", "close", "volume", "vwap", "trade_count", "timestamp" ], "properties": { "low": { "type": "number" }, "high": { "type": "number" }, "open": { "type": "number" }, "vwap": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "close": { "type": "number" }, "ticker": { "type": "string" }, "volume": { "type": "number" }, "timestamp": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "trade_count": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "additionalProperties": false } }, "adjusted": { "type": "boolean" } }, "additionalProperties": false } } } }, "402": { "description": "Payment required" } } } }, "/api/v1/losers": { "get": { "x-zeroclick-services": [ "stock-quotes" ], "summary": "The day's biggest percentage losers across US equities, with current and previous-day OHLCV per ticker. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.", "parameters": [ { "in": "query", "name": "limit", "schema": { "type": "integer", "maximum": 100, "exclusiveMinimum": 0 } } ], "x-payment-info": { "protocols": [ { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } }, { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } } ], "offers": [ { "amount": "20000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "$0.020000 per request (losers, service stock-quotes)", "intent": "charge", "method": "tempo" } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "rates": [ { "service": "stock-quotes", "meter": "losers", "unit": "request", "unitSize": 1, "priceUsd": "0.020000", "includedUnits": 0 } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "source", "as_of", "direction", "count", "tickers" ], "properties": { "as_of": { "type": "string" }, "count": { "type": "number" }, "source": { "type": "string", "const": "x402stock" }, "tickers": { "type": "array", "items": { "type": "object", "required": [ "ticker", "change", "change_percent", "updated" ], "properties": { "day": { "type": "object", "required": [ "open", "high", "low", "close", "volume", "vwap" ], "properties": { "low": { "type": "number" }, "high": { "type": "number" }, "open": { "type": "number" }, "vwap": { "type": "number" }, "close": { "type": "number" }, "volume": { "type": "number" } }, "additionalProperties": false }, "change": { "type": "number" }, "ticker": { "type": "string" }, "updated": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "previous_day": { "type": "object", "required": [ "open", "high", "low", "close", "volume", "vwap" ], "properties": { "low": { "type": "number" }, "high": { "type": "number" }, "open": { "type": "number" }, "vwap": { "type": "number" }, "close": { "type": "number" }, "volume": { "type": "number" } }, "additionalProperties": false }, "change_percent": { "type": "number" } }, "additionalProperties": false } }, "direction": { "enum": [ "gainers", "losers" ], "type": "string" } }, "additionalProperties": false } } } }, "402": { "description": "Payment required" } } } }, "/api/v1/market-pulse": { "get": { "x-zeroclick-services": [ "stock-quotes" ], "summary": "Use to find the day's biggest movers in one call. Returns the top 10 gainers and top 10 losers by percent move with price, the current US market session status (open, closed, pre, or post), and the latest market news headlines. No ticker needed. Built for agents scanning what is moving today. From x402stock, a pay-per-call market & economic data API. Pay per request in USDC via x402, no API key.", "parameters": [ { "in": "query", "name": "limit", "schema": { "type": "integer", "maximum": 50, "exclusiveMinimum": 0 } } ], "x-payment-info": { "protocols": [ { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } }, { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } } ], "offers": [ { "amount": "30000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "$0.030000 per request (market_pulse, service stock-quotes)", "intent": "charge", "method": "tempo" } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.030000" }, "rates": [ { "service": "stock-quotes", "meter": "market_pulse", "unit": "request", "unitSize": 1, "priceUsd": "0.030000", "includedUnits": 0 } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "source", "as_of", "market_status", "gainers", "losers", "news" ], "properties": { "news": { "type": "array", "items": { "type": "object", "required": [ "title", "url", "publisher", "published_at", "tickers" ], "properties": { "url": { "type": "string" }, "title": { "type": "string" }, "tickers": { "type": "array", "items": { "type": "string" } }, "publisher": { "type": "string" }, "published_at": { "type": "string" } }, "additionalProperties": false } }, "as_of": { "type": "string" }, "losers": { "type": "array", "items": { "type": "object", "required": [ "ticker", "change_percent", "price" ], "properties": { "price": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "ticker": { "type": "string" }, "change_percent": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "additionalProperties": false } }, "source": { "type": "string", "const": "x402stock" }, "gainers": { "type": "array", "items": { "type": "object", "required": [ "ticker", "change_percent", "price" ], "properties": { "price": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "ticker": { "type": "string" }, "change_percent": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "additionalProperties": false } }, "market_status": { "anyOf": [ { "type": "object", "required": [ "market", "early_hours", "after_hours" ], "properties": { "market": { "type": "string" }, "after_hours": { "type": "boolean" }, "early_hours": { "type": "boolean" } }, "additionalProperties": false }, { "type": "null" } ] } }, "additionalProperties": false } } } }, "402": { "description": "Payment required" } } } }, "/api/v1/open-close/{ticker}": { "get": { "x-zeroclick-services": [ "stock-quotes" ], "summary": "Official open, close, high, low, volume, plus pre-market and after-hours prices for a ticker on a given date. Pass `?date=YYYY-MM-DD` (required). From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.", "parameters": [ { "in": "path", "name": "ticker", "schema": { "type": "string" }, "example": "AAPL", "required": true, "description": "US-listed ticker symbol (uppercase), e.g. AAPL." }, { "in": "query", "name": "date", "schema": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "required": true, "example": "sample" }, { "in": "query", "name": "adjusted", "schema": { "type": "boolean", "default": true } } ], "x-payment-info": { "protocols": [ { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } }, { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } } ], "offers": [ { "amount": "10000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "$0.010000 per request (open_close, service stock-quotes)", "intent": "charge", "method": "tempo" } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "rates": [ { "service": "stock-quotes", "meter": "open_close", "unit": "request", "unitSize": 1, "priceUsd": "0.010000", "includedUnits": 0 } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "ticker", "data", "source", "as_of" ], "properties": { "data": { "type": "object", "required": [ "date", "open", "high", "low", "close", "volume", "pre_market", "after_hours" ], "properties": { "low": { "type": "number" }, "date": { "type": "string" }, "high": { "type": "number" }, "open": { "type": "number" }, "close": { "type": "number" }, "volume": { "type": "number" }, "pre_market": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "after_hours": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "additionalProperties": false }, "as_of": { "type": "string" }, "source": { "type": "string", "const": "x402stock" }, "ticker": { "type": "string" }, "feedback": { "type": "object", "required": [ "endpoint", "method", "free", "note" ], "properties": { "free": { "type": "boolean" }, "note": { "type": "string" }, "method": { "type": "string", "const": "POST" }, "endpoint": { "type": "string" } }, "additionalProperties": false } }, "additionalProperties": false } } } }, "402": { "description": "Payment required" } } } }, "/api/v1/prev-close/{ticker}": { "get": { "x-zeroclick-services": [ "stock-quotes" ], "summary": "Open, high, low, close, volume, and VWAP for a ticker's most recent completed trading day. One call returns one bar, handy for prior-close reference without setting a date range. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.", "parameters": [ { "in": "path", "name": "ticker", "schema": { "type": "string" }, "example": "AAPL", "required": true, "description": "US-listed ticker symbol (uppercase), e.g. AAPL." } ], "x-payment-info": { "protocols": [ { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } }, { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } } ], "offers": [ { "amount": "10000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "$0.010000 per request (prev_close, service stock-quotes)", "intent": "charge", "method": "tempo" } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "rates": [ { "service": "stock-quotes", "meter": "prev_close", "unit": "request", "unitSize": 1, "priceUsd": "0.010000", "includedUnits": 0 } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "ticker", "data", "source", "as_of" ], "properties": { "data": { "anyOf": [ { "type": "object", "required": [ "open", "high", "low", "close", "volume", "vwap", "trade_count", "timestamp" ], "properties": { "low": { "type": "number" }, "high": { "type": "number" }, "open": { "type": "number" }, "vwap": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "close": { "type": "number" }, "volume": { "type": "number" }, "timestamp": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "trade_count": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "as_of": { "type": "string" }, "source": { "type": "string", "const": "x402stock" }, "ticker": { "type": "string" }, "feedback": { "type": "object", "required": [ "endpoint", "method", "free", "note" ], "properties": { "free": { "type": "boolean" }, "note": { "type": "string" }, "method": { "type": "string", "const": "POST" }, "endpoint": { "type": "string" } }, "additionalProperties": false } }, "additionalProperties": false } } } }, "402": { "description": "Payment required" } } } }, "/api/v1/quote/{ticker}": { "get": { "x-zeroclick-services": [ "stock-quotes" ], "summary": "Get the latest available price for any US-listed stock: the most recent 1-minute bar close plus today's OHLCV, change, and previous close. Currently 15 minutes delayed; each response carries `is_delayed: true`. Real-time pricing lands when the data plan is upgraded. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.", "parameters": [ { "in": "path", "name": "ticker", "schema": { "type": "string" }, "example": "AAPL", "required": true, "description": "US-listed ticker symbol (uppercase), e.g. AAPL." } ], "x-payment-info": { "protocols": [ { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } }, { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } } ], "offers": [ { "amount": "10000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "$0.010000 per request (quote, service stock-quotes)", "intent": "charge", "method": "tempo" } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "rates": [ { "service": "stock-quotes", "meter": "quote", "unit": "request", "unitSize": 1, "priceUsd": "0.010000", "includedUnits": 0 } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "ticker", "data", "source", "as_of" ], "properties": { "data": { "type": "object", "required": [ "price", "change", "change_percent", "previous_close", "timestamp", "is_delayed", "delayed_by" ], "properties": { "day": { "type": "object", "required": [ "open", "high", "low", "close", "volume" ], "properties": { "low": { "type": "number" }, "high": { "type": "number" }, "open": { "type": "number" }, "vwap": { "type": "number" }, "close": { "type": "number" }, "volume": { "type": "number" } }, "additionalProperties": false }, "price": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "change": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "timestamp": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "delayed_by": { "type": "string" }, "is_delayed": { "type": "boolean" }, "change_percent": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "previous_close": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "additionalProperties": false }, "as_of": { "type": "string" }, "source": { "type": "string", "const": "x402stock" }, "ticker": { "type": "string" }, "feedback": { "type": "object", "required": [ "endpoint", "method", "free", "note" ], "properties": { "free": { "type": "boolean" }, "note": { "type": "string" }, "method": { "type": "string", "const": "POST" }, "endpoint": { "type": "string" } }, "additionalProperties": false } }, "additionalProperties": false } } } }, "402": { "description": "Payment required" } } } }, "/api/v1/snapshot/{ticker}": { "get": { "x-zeroclick-services": [ "stock-quotes" ], "summary": "Single-call snapshot of a ticker's current state: last quote, last trade, today's OHLC + volume + VWAP, previous-day OHLC, today's change vs previous close. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.", "parameters": [ { "in": "path", "name": "ticker", "schema": { "type": "string" }, "example": "AAPL", "required": true, "description": "US-listed ticker symbol (uppercase), e.g. AAPL." } ], "x-payment-info": { "protocols": [ { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } }, { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } } ], "offers": [ { "amount": "10000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "$0.010000 per request (snapshot, service stock-quotes)", "intent": "charge", "method": "tempo" } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "rates": [ { "service": "stock-quotes", "meter": "snapshot", "unit": "request", "unitSize": 1, "priceUsd": "0.010000", "includedUnits": 0 } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "ticker", "data", "source", "as_of" ], "properties": { "data": { "type": "object", "properties": { "day": { "type": "object", "required": [ "open", "high", "low", "close", "volume" ], "properties": { "low": { "type": "number" }, "high": { "type": "number" }, "open": { "type": "number" }, "vwap": { "type": "number" }, "close": { "type": "number" }, "volume": { "type": "number" } }, "additionalProperties": false }, "change": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "last_quote": { "type": "object", "required": [ "bid_price", "bid_size", "ask_price", "ask_size", "timestamp" ], "properties": { "ask_size": { "type": "number" }, "bid_size": { "type": "number" }, "ask_price": { "type": "number" }, "bid_price": { "type": "number" }, "timestamp": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, "last_trade": { "type": "object", "required": [ "price", "size", "exchange_id", "timestamp", "conditions" ], "properties": { "size": { "type": "number" }, "price": { "type": "number" }, "timestamp": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "conditions": { "type": "array", "items": { "type": "number" } }, "exchange_id": { "type": "number" } }, "additionalProperties": false }, "previous_day": { "type": "object", "required": [ "open", "high", "low", "close", "volume" ], "properties": { "low": { "type": "number" }, "high": { "type": "number" }, "open": { "type": "number" }, "vwap": { "type": "number" }, "close": { "type": "number" }, "volume": { "type": "number" } }, "additionalProperties": false }, "change_percent": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "last_minute_bar": { "type": "object", "required": [ "open", "high", "low", "close", "volume", "vwap", "timestamp" ], "properties": { "low": { "type": "number" }, "high": { "type": "number" }, "open": { "type": "number" }, "vwap": { "type": "number" }, "close": { "type": "number" }, "volume": { "type": "number" }, "timestamp": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "trade_count": { "type": "number" }, "accumulated_volume": { "type": "number" } }, "additionalProperties": false } }, "additionalProperties": false }, "as_of": { "type": "string" }, "source": { "type": "string", "const": "x402stock" }, "ticker": { "type": "string" }, "feedback": { "type": "object", "required": [ "endpoint", "method", "free", "note" ], "properties": { "free": { "type": "boolean" }, "note": { "type": "string" }, "method": { "type": "string", "const": "POST" }, "endpoint": { "type": "string" } }, "additionalProperties": false } }, "additionalProperties": false } } } }, "402": { "description": "Payment required" } } } }, "/api/v1/unified-snapshot": { "get": { "x-zeroclick-services": [ "stock-quotes" ], "summary": "Snapshot a list of US-listed tickers at once: for each symbol, the company name, market session, current price, day change and percent change, day OHLCV with VWAP, and previous close. Pass a comma-separated list via `?tickers=AAPL,MSFT,NVDA` (up to 250). Built for pricing a watchlist or portfolio in a single request. From x402stock, a market & economic data API (x402, USDC).", "parameters": [ { "in": "query", "name": "tickers", "schema": { "type": "string", "minLength": 1 }, "required": true, "example": "sample" } ], "x-payment-info": { "protocols": [ { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } }, { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } } ], "offers": [ { "amount": "20000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "$0.020000 per request (unified_snapshot, service stock-quotes)", "intent": "charge", "method": "tempo" } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "rates": [ { "service": "stock-quotes", "meter": "unified_snapshot", "unit": "request", "unitSize": 1, "priceUsd": "0.020000", "includedUnits": 0 } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "source", "as_of", "count", "tickers" ], "properties": { "as_of": { "type": "string" }, "count": { "type": "number" }, "source": { "type": "string", "const": "x402stock" }, "tickers": { "type": "array", "items": { "type": "object", "required": [ "ticker", "name", "market_status", "price", "change", "change_percent", "day", "previous_close", "updated" ], "properties": { "day": { "anyOf": [ { "type": "object", "required": [ "open", "high", "low", "close", "volume", "vwap" ], "properties": { "low": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "high": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "open": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "vwap": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "close": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "volume": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "price": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "change": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "ticker": { "type": "string" }, "updated": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "market_status": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "change_percent": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "previous_close": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "additionalProperties": false } } }, "additionalProperties": false } } } }, "402": { "description": "Payment required" } } } } }, "x-zeroclick-navigation-footer": { "instructions": [ "Use this spec if it contains the operation and details you need. Otherwise, search or open a relevant service spec using the links below.", "Find service slugs in x-zeroclick-services or x-payment-info.rates[].service; use them in serviceSpecTemplate, never as request values.", "URL-encode template values. Search is ranked; service, path, and method filters are exact. Filters combine.", "Pages contain up to 10 operations; follow info.x-next or the Link header if you need more results. Shared operations retain all selector values." ], "fullSpec": "https://agents.x402stock.xyz/zcj/jobosa66czb2/openapi.json", "services": "https://agents.x402stock.xyz/zcj/jobosa66czb2/services", "serviceSpecTemplate": "https://agents.x402stock.xyz/zcj/jobosa66czb2/services/{slug}/openapi.json", "searchTemplate": "https://agents.x402stock.xyz/zcj/jobosa66czb2/openapi.json?q={text}", "operationTemplate": "https://agents.x402stock.xyz/zcj/jobosa66czb2/openapi.json?path={path}&method={method}", "firstPage": "https://agents.x402stock.xyz/zcj/jobosa66czb2/openapi.json?page=1" } }