X4
Identity & Enrichment · x402 · early usage
Risk x-ray for a whole watchlist or portfolio in one call
Risk x-ray for a whole watchlist or portfolio in one call. Pass `?tickers=AAPL,MSFT,NVDA` (up to 25; optional `?weights=`). Returns per-holding price, sector and cap, plus portfolio concentration (top-weight, Herfindahl, diversification score), sector concent…
by x402stock.xyz · discovered, not yet claimed by its owner · updated 2026-09-22
30d calls2
30d payers1
MethodGET
Outputjson
Mirrored from Coinbase's public x402 Bazaar. The description is the provider's own text and has not been reviewed here; the payment requirements are copied as published.
What it does
Risk x-ray for a whole watchlist or portfolio in one call. Pass `?tickers=AAPL,MSFT,NVDA` (up to 25; optional `?weights=`). Returns per-holding price, sector and cap, plus portfolio concentration (top-weight, Herfindahl, diversification score), sector concentration, market-cap distribution, weighted day performance and risk flags. Replaces dozens of per-holding calls. From x402stock
Tags: bazaar
Call contract
- Method
- GET
- Input
- query parameters
- Output
- json
- Last paid call
- 2026-09-22
Input example from Bazaar metadata
{
"tickers": "AAPL,MSFT,NVDA"
}Output example
{
"as_of": "2026-06-08T12:00:00.000Z",
"disclaimer": "Factual quantitative analysis, not investment advice. Inputs are delayed/periodic; verify before acting.",
"holding_count": 3,
"holdings": [
{
"cap_bucket": "mega",
"change_percent": 0.2,
"market_cap": 3100000000000,
"name": "Apple Inc.",
"price": 205.4,
"sector": "Electronic Computers",
"ticker": "AAPL",
"weight": 0.3333
},
{
"cap_bucket": "mega",
"change_percent": 0.7,
"market_cap": 3400000000000,
"name": "Microsoft Corp",
"price": 462.1,
"sector": "Services-Prepackaged Software",
"ticker": "MSFT",
"weight": 0.3333
},
{
"cap_bucket": "mega",
"change_percent": 1.6,
"market_cap": 3300000000000,
"name": "NVIDIA Corp",
"price": 138.9,
"sector": "Electronic Computers",
"ticker": "NVDA",
"weight": 0.3333
}
],
"sections": {
"prices": "ok",
"profiles": "ok"
},
"source": "x402stock",
"summary": {
"concentration": {
"diversification_score": 66.7,
"hhi": 0.3333,
"label": "moderate",
"top3_weight": 1,
"top_weight": 0.3333
},
"day_change_percent": 0.82,
"market_cap_distribution": {
"large": 0,
"mega": 1,
"micro": 0,
"mid": 0,
"small": 0,
"unknown": 0
},
"performance": {
"best": {
"change_percent": 1.6,
"ticker": "NVDA"
},
"worst": {
"change_percent": 0.2,
"ticker": "AAPL"
}
},
"risk_flags": [
"sector_concentration",
"few_holdings"
],
"sector_concentration": {
"coverage": 1,
"hhi": 0.56,
"label": "high",
"top_sectors": [
{
"sector": "Electronic Computers",
"weight": 0.6667
},
{
"sector": "Services-Prepackaged Software",
"weight": 0.3333
}
]
}
},
"weighting": "equal"
}Use with an agent
- Discover. Agents find this listing with
GET https://bazaar.saylorinnovations.com/discovery/search?query=…, the MCP toolsearch_resources, or/discovery/resources. - Inspect. Fetch
/resources/39960.jsonfor the price and payment options. - Pay. Call
GET https://x402stock.xyz/api/v1/portfolio/xray. The provider answers402with its payment requirements. An x402 client signs one of the options below and retries withPAYMENT-SIGNATURE. - Execute. The provider returns
200with the data. Agent Bazaar is not in the request path and never sees your payment.
For humans
You don't need an account or an API key; you need a wallet holding a small amount of USDC on Base, and an x402-capable client (see the examples below). Call the endpoint unpaid first to see exactly what it asks for.
Pricing & payment
- Price
- $0.25 / request
- Protocol
- x402 v2
- Auth
- No account or API key. Pay per request.
- Networks
- Base
- Demand
- 2 calls · 1 unique payers in 30d (public x402 Bazaar data)
x402 payment requirements
| Scheme | Network | Asset | Amount | Pay to | Timeout |
|---|---|---|---|---|---|
| exact | Base eip155:8453 | USDC | $0.25 | 0x3070Fbb3803819fB5BdfE9286fdc6325A877fA85 | 300s |
accepts[] (raw JSON)
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0x3070Fbb3803819fB5BdfE9286fdc6325A877fA85",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "250000",
"amountUsd": 0.25,
"maxTimeoutSeconds": 300
}
]Schemas
Output schema (JSON Schema)
{
"properties": {
"example": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"as_of": {
"type": "string"
},
"disclaimer": {
"type": "string"
},
"holding_count": {
"type": "number"
},
"holdings": {
"items": {
"additionalProperties": false,
"properties": {
"cap_bucket": {
"type": "string"
},
"change_percent": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"market_cap": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"price": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"sector": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"ticker": {
"type": "string"
},
"weight": {
"type": "number"
}
},
"required": [
"ticker",
"name",
"price",
"change_percent",
"market_cap",
"sector",
"cap_bucket",
"weight"
],
"type": "object"
},
"type": "array"
},
"sections": {
"additionalProperties": {
"type": "string"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"source": {
"const": "x402stock",
"type": "string"
},
"summary": {
"additionalProperties": false,
"properties": {
"concentration": {
"additionalProperties": false,
"properties": {
"diversification_score": {
"type": "number"
},
"hhi": {
"type": "number"
},
"label": {
"type": "string"
},
"top3_weight": {
"type": "number"
},
"top_weight": {
"type": "number"
}
},
"required": [
"top_weight",
"top3_weight",
"hhi",
"diversification_score",
"label"
],
"type": "object"
},
"day_change_percent": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"market_cap_distribution": {
"additionalProperties": {
"type": "number"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"performance": {
"additionalProperties": false,
"properties": {
"best": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"change_percent": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"ticker": {
"type": "string"
}
},
"required": [
"ticker",
"change_percent"
],
"type": "object"
},
{
"type": "null"
}
]
},
"worst": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"change_percent": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"ticker": {
"type": "string"
}
},
"required": [
"ticker",
"change_percent"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"best",
"worst"
],
"type": "object"
},
"risk_flags": {
"items": {
"type": "string"
},
"type": "array"
},
"sector_concentration": {
"additionalProperties": false,
"properties": {
"coverage": {
"type": "number"
},
"hhi": {
"type": "number"
},
"label": {
"type": "string"
},
"top_sectors": {
"items": {
"additionalProperties": false,
"properties": {
"sector": {
"type": "string"
},
"weight": {
"type": "number"
}
},
"required": [
"sector",
"weight"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"hhi",
"label",
"coverage",
"top_sectors"
],
"type": "object"
}
},
"required": [
"day_change_percent",
"sector_concentration",
"market_cap_distribution",
"concentration",
"performance",
"risk_flags"
],
"type": "object"
},
"weighting": {
"enum": [
"equal",
"custom"
],
"type": "string"
}
},
"required": [
"source",
"as_of",
"holding_count",
"weighting",
"sections",
"summary",
"holdings",
"disclaimer"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}Example shape — generated from the schema, not a captured live response
{
"example": {
"as_of": "string",
"disclaimer": "string",
"holding_count": 0,
"holdings": [
{
"cap_bucket": "string",
"change_percent": null,
"market_cap": null,
"name": null,
"price": null,
"sector": null,
"ticker": "string",
"weight": 0
}
],
"sections": {},
"source": "string",
"summary": {
"concentration": {
"diversification_score": 0,
"hhi": 0,
"label": "string",
"top3_weight": 0,
"top_weight": 0
},
"day_change_percent": null,
"market_cap_distribution": {},
"performance": {
"best": null,
"worst": null
},
"risk_flags": [
"string"
],
"sector_concentration": {
"coverage": 0,
"hhi": 0,
"label": "string",
"top_sectors": [
{
"sector": "string",
"weight": 0
}
]
}
},
"weighting": "equal"
},
"type": "string"
}Examples
curl
curl "https://x402stock.xyz/api/v1/portfolio/xray"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paidJavaScript
const res = await fetch("https://x402stock.xyz/api/v1/portfolio/xray");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}Python
import httpx
res = httpx.get("https://x402stock.xyz/api/v1/portfolio/xray")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerDetails
- Provider
- x402stock.xyz
- Endpoint
- https://x402stock.xyz/api/v1/portfolio/xray
- Machine-readable
/resources/39960.json