Market Intelligence API (core)

Goal-driven scan: name an objective and constraints, get ranked symbols with supporting and conflicting evidence grouped by independent source (spot DEX flow, perp positioning, smart-money wallets), typed risk factors, data quality, the live 1h hit rate of the signal and the next calls to make. Use instead of chaining screeners. Objectives: unusual_buying, unusual_selling, breakout, breakdown, crowded_positioning, smart_money_accumulation, smart_money_distribution.

{
  "type": "object",
  "properties": {
    "maxResults": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 10,
      "description": "Maximum number of ranked symbols (default 10)"
    },
    "include": {
      "description": "Blocks to return; default all",
      "type": "array",
      "items": {
        "enum": [
          "metrics",
          "evidence",
          "risk_factors",
          "data_quality",
          "track_record",
          "market_context"
        ],
        "type": "string"
      }
    },
    "assetClass": {
      "enum": [
        "crypto",
        "us_equity",
        "perp_only"
      ],
      "type": "string",
      "description": "Restrict to crypto, us_equity or perp_only symbols"
    },
    "minBuyPressure": {
      "default": 60,
      "minimum": 50,
      "maximum": 100,
      "description": "Pressure on the objective's side (buy for buying, sell for selling)",
      "type": "number"
    },
    "minVolumeMultiple": {
      "default": 1.5,
      "type": "number",
      "description": "Volume vs the symbol's own baseline"
    },
    "objective": {
      "enum": [
        "unusual_buying",
        "unusual_selling",
        "breakout",
        "breakdown",
        "crowded_positioning",
        "smart_money_accumulation",
        "smart_money_distribution"
      ],
      "type": "string",
      "description": "What to look for"
    },
    "minVolumeUsd": {
      "default": 0,
      "type": "number",
      "description": "USD traded in the window"
    },
    "minConfidence": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "default": 50,
      "description": "Minimum signal confidence, 0-100"
    },
    "universe": {
      "description": "Symbols to scan (max 100); omit for all covered symbols",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "minIndependentSources": {
      "default": 1,
      "minimum": 1,
      "maximum": 3,
      "description": "Distinct sources confirming the direction",
      "type": "integer"
    },
    "window": {
      "default": "5m",
      "enum": [
        "1m",
        "5m",
        "15m"
      ],
      "type": "string",
      "description": "Aggregation window of the live trade buckets: 1m, 5m (default) or 15m"
    }
  },
  "required": [
    "objective"
  ]
}

FREE sample of the premium decision: the latest hourly decision (action, direction, conviction, pillar scores) of every symbol with live on-chain trading (about 40, e.g. ETHUSD, BTCUSD, NVDA, TSLA, SPY, AAPL), delayed at least an hour, with what the price did 1h/4h/24h later. Judge the decisions before buying a live one.

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "description": "Optional; omit for all ten symbols"
    }
  }
}

FREE: tell the operator what was missing or wrong (a route or tool you expected, a symbol without data, a confusing parameter). Read by a human; it decides the next routes.

{
  "type": "object",
  "properties": {
    "rating": {
      "maximum": 5,
      "type": "integer",
      "minimum": 1,
      "description": "Optional 1-5 rating of the route or tool"
    },
    "missing": {
      "type": "string",
      "description": "What you needed and did not find"
    },
    "message": {
      "type": "string",
      "description": "Anything else, up to 1000 characters"
    },
    "route": {
      "type": "string",
      "description": "Route or tool it is about (optional)"
    }
  }
}

Cheap live decision ($0.05): action (STRONG_BUY..STRONG_SELL), direction, conviction, a GO/WAIT answer for a side, the stance of each pillar and the measured hit rate. Same engine as get_decision on the full server /mcp ($1), without the trade plan, execution check, evidence and risks. Use as the default decision; decision.pre_trade answers only go/no-go timing for a side, decision.sample is free but an hour old.

{
  "type": "object",
  "properties": {
    "side": {
      "enum": [
        "buy",
        "sell"
      ],
      "type": "string",
      "description": "Optional: answers GO / GO_SMALL / WAIT / NO_GO for this side"
    },
    "symbol": {
      "type": "string",
      "description": "Crypto pair (ETHUSD), US ticker (NVDA) or ISIN"
    }
  },
  "required": [
    "symbol"
  ]
}

FREE: live hit rate of the published signals over 7/30/90 days per horizon (5m, 15m, 1h, 24h), by signal and by confidence, plus the perp crowding record. Judge the signals before buying them.

{
  "type": "object",
  "properties": {}
}

Cheapest call ($0.001): headline numbers of one symbol right now: price, change, buy pressure, signal, event, confidence and trade count.

{
  "type": "object",
  "properties": {
    "window": {
      "default": "5m",
      "enum": [
        "1m",
        "5m",
        "15m"
      ],
      "type": "string",
      "description": "Aggregation window of the live trade buckets: 1m, 5m (default) or 15m"
    },
    "symbol": {
      "type": "string",
      "description": "e.g. ETHUSD, BTCUSD, NVDA, TSLA"
    }
  },
  "required": [
    "symbol"
  ]
}

Right before a trade: 'I want to buy (or sell) SYMBOL - is now a good moment?'. Returns a verdict (FAVORABLE, CAUTION, UNFAVORABLE), a score and the checks behind it: order flow, momentum, volatility, adverse events, market regime and news/filings of the last 24h. Use when you already know the symbol and side and only need go/no-go timing; for an action with conviction use decision.lite.

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "description": "e.g. ETHUSD, BTCUSD, NVDA, TSLA"
    },
    "window": {
      "default": "5m",
      "enum": [
        "1m",
        "5m",
        "15m"
      ],
      "type": "string",
      "description": "Aggregation window of the live trade buckets: 1m, 5m (default) or 15m"
    },
    "side": {
      "default": "buy",
      "enum": [
        "buy",
        "sell"
      ],
      "type": "string",
      "description": "The side you intend to trade: buy or sell"
    }
  },
  "required": [
    "symbol"
  ]
}

Due diligence before buying any token (Base by default; also ethereum, arbitrum, optimism, polygon, solana). EVM: simulated sell and buy (honeypot check), owner and upgradeable proxy, mint, blacklist, pause and fee functions, liquidity, LP burn, observed buy tax, last-hour flow. Solana mints: mint and freeze authority, Token-2022 transfer fee, permanent delegate, transfer hook, pause and top-wallet concentration. Verdict LOW_RISK, CAUTION or HIGH_RISK. Use before buying a token; for the price you would get on chain use token.swap_quote.

{
  "type": "object",
  "properties": {
    "chain": {
      "default": "base",
      "enum": [
        "base",
        "ethereum",
        "arbitrum",
        "optimism",
        "polygon",
        "solana"
      ],
      "type": "string",
      "description": "Chain of the token or pool: base (default), ethereum, arbitrum, optimism or polygon (solana where listed)"
    },
    "address": {
      "type": "string",
      "description": "0x-prefixed ERC-20 contract, or a base58 Solana mint"
    }
  },
  "required": [
    "address"
  ]
}

Tokens launched in the last hour on Base or Ethereum, already risk-checked: every new Uniswap v2/v3/v4 or Aerodrome pool against ETH, WETH or USDC with liquidity, sell simulation, v4 hook powers, first trades and a verdict (LOW_RISK, CAUTION, HIGH_RISK).

{
  "type": "object",
  "properties": {
    "minutes": {
      "type": "integer",
      "minimum": 5,
      "maximum": 1440,
      "default": 60,
      "description": "Look-back for new pools in minutes (default 60)"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 30,
      "description": "Maximum number of results"
    },
    "chain": {
      "default": "base",
      "enum": [
        "base",
        "ethereum"
      ],
      "type": "string",
      "description": "Chain of the token or pool: base (default), ethereum, arbitrum, optimism or polygon (solana where listed)"
    },
    "verdict": {
      "enum": [
        "LOW_RISK",
        "CAUTION",
        "HIGH_RISK"
      ],
      "type": "string",
      "description": "Keep only tokens with this risk verdict: LOW_RISK, CAUTION or HIGH_RISK"
    },
    "includeEstablished": {
      "default": false,
      "type": "boolean",
      "description": "Also list new pools of tokens that already existed a day earlier (new markets, not launches)"
    },
    "minLiquidityUsd": {
      "default": 1000,
      "type": "number",
      "description": "Minimum pool liquidity in USD"
    }
  }
}

Right before an on-chain swap ($0.002): how much you get now on the best route (Uniswap v2/v3/v4, Aerodrome, direct or through WETH) on Base, Ethereum, Arbitrum, Optimism or Polygon, with price impact, minimum received at your slippage and alternatives. Simulated, nothing executed.

{
  "type": "object",
  "properties": {
    "sell": {
      "type": "string",
      "description": "ETH, WETH, USDC or a 0x token address"
    },
    "amount": {
      "type": "string",
      "description": "Sell amount in whole units, e.g. 1000"
    },
    "chain": {
      "default": "base",
      "enum": [
        "base",
        "ethereum",
        "arbitrum",
        "optimism",
        "polygon"
      ],
      "type": "string",
      "description": "Chain of the token or pool: base (default), ethereum, arbitrum, optimism or polygon (solana where listed)"
    },
    "buy": {
      "type": "string",
      "description": "ETH, WETH, USDC or a 0x token address"
    },
    "slippageBps": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5000,
      "default": 50,
      "description": "Slippage tolerance for the minimum received, in basis points"
    }
  },
  "required": [
    "sell",
    "buy",
    "amount"
  ]
}

Next market-moving events ($0.002) in UTC with importance, from official calendars: US CPI, jobs report, PCE, GDP, PPI, JOLTS (BLS, BEA), FOMC and ECB rate decisions. Check before opening a position.

{
  "type": "object",
  "properties": {
    "importance": {
      "default": "medium",
      "enum": [
        "high",
        "medium",
        "low"
      ],
      "type": "string",
      "description": "Minimum importance of the events to include"
    },
    "region": {
      "default": "all",
      "enum": [
        "all",
        "us",
        "eu"
      ],
      "type": "string",
      "description": "Region: all, us or eu"
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 90,
      "default": 14,
      "description": "Number of days to cover (look-back; days ahead for calendars)"
    }
  }
}

Fundamentals of up to 10 US-listed companies in one call ($0.03): per ticker revenue, earnings, margins, growth, balance sheet and a fundamental signal from SEC filings.

{
  "type": "object",
  "properties": {
    "symbols": {
      "minItems": 1,
      "items": {
        "type": "string"
      },
      "maxItems": 10,
      "description": "US tickers, e.g. [\"AAPL\", \"MSFT\"]",
      "type": "array"
    }
  },
  "required": [
    "symbols"
  ]
}

Why is a symbol moving? ($0.02) The 15-minute move and its likely drivers from every source (on-chain flow, unusual activity, smart money, perp crowding, 48h news, SEC filings, insiders) with direction and weight, plus a one-sentence summary. Crypto, tokenized stocks and US stocks.

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "description": "e.g. ETHUSD, NVDA, TSLA"
    }
  },
  "required": [
    "symbol"
  ]
}

Get market-wide breadth, buying pressure, momentum, unusual activity and data freshness. Use for breadth, regime and the top movers in one call; for a goal-driven scan use market.opportunities.

{
  "type": "object",
  "properties": {
    "window": {
      "default": "5m",
      "enum": [
        "1m",
        "5m",
        "15m"
      ],
      "type": "string",
      "description": "Aggregation window of the live trade buckets: 1m, 5m (default) or 15m"
    }
  }
}

News for one symbol ($0.003): headlines and SEC filing events tagged with the ticker (e.g. NVDA, ETHUSD), newest first, with publisher attribution, sentiment and an event type and materiality where classified.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 10,
      "description": "Maximum number of results"
    },
    "symbol": {
      "type": "string",
      "description": "Ticker or crypto pair, e.g. NVDA, TSLA, ETHUSD"
    }
  },
  "required": [
    "symbol"
  ]
}