# Market Intelligence API – Portfolio Risk Check

> Market Intelligence API – Portfolio Risk Check is a paid API for AI agents from api.marketintelligenceapi.com, paid per call via x402, $0.25/call, status unknown (last checked 2026-10-12).

Analyzes up to 15 equity/crypto positions and 5 on-chain tokens in a single call, returning concentration, correlations, volatility, 1-day 95% VaR, trading decisions, token risk verdicts, upcoming macro events, and actionable flags.

## Facts

- Endpoint: POST https://api.marketintelligenceapi.com/api/v1/portfolio/check?utm_source=zero.xyz
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/market-intelligence-api-portfolio-risk-check-56833b9e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LAl9m6SQmABxg00VTeRCa

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability market-intelligence-api-portfolio-risk-check-56833b9e -d '<json body>'
```

Example prompt: Can you run a full risk check on my portfolio — I'm holding $5,000 in BTCUSD, $3,000 in ETHUSD, $2,000 in NVDA, and $1,500 in TSLA, plus a $500 position in the on-chain token at address 0xabc...123 on Base — and tell me the VaR, concentration issues, correlations, any macro events in the next 24 hours, and what trades to make?

## When to prefer this

Choose this endpoint when you need a comprehensive, multi-dimensional risk snapshot of a mixed portfolio (equities + crypto + on-chain tokens) in a single low-cost call. It is ideal for pre-trade portfolio reviews, daily risk monitoring, or before answering a user question about overall portfolio health. Prefer it over single-asset endpoints when you need cross-asset correlation and concentration analysis alongside individual signals and macro event awareness.

## Known failure modes

- Exceeding 15 positions or 5 on-chain tokens returns a validation error
- Invalid or unrecognized symbol (e.g. misspelled ticker) may result in partial results or error for that position
- Missing both quantity and valueUsd for a position causes a schema validation failure
- Unsupported blockchain chain returns an enum validation error
- Payment not completed (x402 protocol) results in a 402 Payment Required response
- Stale or illiquid on-chain token data may reduce VaR accuracy

## How this service works

Crypto and stock portfolio risk check ($0.25): POST up to 15 positions (symbol + valueUsd or quantity) and 5 on-chain tokens; get concentration, correlations, volatility and one-day 95% VaR from hourly on-chain data, the current decision per symbol, token risk verdicts, macro events in the next 24h and flags with what to fix. Use to review holdings in one call.

## Output

Returns a structured JSON object with: portfolio-level concentration score, pairwise correlation matrix, volatility measures, 1-day 95% VaR computed from hourly on-chain data, a current buy/hold/sell decision for each equity/crypto symbol, individual risk verdicts for each on-chain token, a list of macro events expected in the next 24 hours, and prioritized flags indicating what to fix in the portfolio.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "tokens": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "address"
    ],
    "properties": {
     "chain": {
      "enum": [
       "base",
       "ethereum",
       "arbitrum",
       "optimism",
       "polygon",
       "solana"
      ],
      "type": "string"
     },
     "address": {
      "type": "string"
     },
     "valueUsd": {
      "type": "number"
     }
    }
   },
   "maxItems": 5
  },
  "decisions": {
   "type": "boolean",
   "default": true,
   "description": "Include the current decision of every symbol"
  },
  "positions": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "symbol"
    ],
    "properties": {
     "symbol": {
      "type": "string",
      "description": "e.g. ETHUSD, BTCUSD, NVDA"
     },
     "quantity": {
      "type": "number",
      "exclusiveMinimum": 0
     },
     "valueUsd": {
      "type": "number",
      "exclusiveMinimum": 0
     }
    }
   },
   "maxItems": 15
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/market-intelligence-api-portfolio-risk-check-56833b9e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.marketintelligenceapi.com](https://www.zero.xyz/host/api.marketintelligenceapi.com/llms.txt)
