xfinlab

Get recent market/company news headlines from XFINLAB's aggregated real-time news feed (RSS-sourced, deduplicated). Optionally filter by ticker/company name. Returns title, source, kind, published_at, url for each item -- no article body text.

{
  "type": "object",
  "properties": {
    "api_key": {
      "type": "string",
      "description": "XFINLAB Intelligence API key (X-API-Key). Omit if supplied via HTTP header instead."
    },
    "marketplace_license_key": {
      "type": "string",
      "description": "Optional: an mcp-marketplace.io license key for this listing's paid tier. If valid, upgrades a free XFINLAB API key's daily quota to Pro for this call. Omit if supplied via the X-Marketplace-License-Key header instead, or if not using a marketplace license."
    },
    "ticker": {
      "type": "string",
      "description": "Optional ticker or company name to filter by, e.g. 'NVDA'."
    },
    "limit": {
      "type": "integer",
      "description": "Max results, 1-100.",
      "default": 20
    }
  },
  "required": []
}

Get FinBERT-based sentiment analysis of recent headlines for a ticker. Returns per-headline label/confidence/score plus an average score. Real model inference, not a fabricated estimate.

{
  "type": "object",
  "properties": {
    "api_key": {
      "type": "string",
      "description": "XFINLAB Intelligence API key (X-API-Key). Omit if supplied via HTTP header instead."
    },
    "marketplace_license_key": {
      "type": "string",
      "description": "Optional: an mcp-marketplace.io license key for this listing's paid tier. If valid, upgrades a free XFINLAB API key's daily quota to Pro for this call. Omit if supplied via the X-Marketplace-License-Key header instead, or if not using a marketplace license."
    },
    "ticker": {
      "type": "string",
      "description": "Ticker to analyze, e.g. 'AAPL'."
    },
    "limit": {
      "type": "integer",
      "description": "Number of recent headlines to analyze, 1-25.",
      "default": 10
    }
  },
  "required": [
    "ticker"
  ]
}

Get confluence direction/confidence, trend, MACD, volume, chart patterns, and market-structure signals (BOS/CHOCH/liquidity-sweep/order-flow/volume-profile/institutional-footprint) for one ticker, computed from real OHLC price data -- the same engine that powers XFINLAB's chart-analysis and ai-analysis pages.

{
  "type": "object",
  "properties": {
    "api_key": {
      "type": "string",
      "description": "XFINLAB Intelligence API key (X-API-Key). Omit if supplied via HTTP header instead."
    },
    "marketplace_license_key": {
      "type": "string",
      "description": "Optional: an mcp-marketplace.io license key for this listing's paid tier. If valid, upgrades a free XFINLAB API key's daily quota to Pro for this call. Omit if supplied via the X-Marketplace-License-Key header instead, or if not using a marketplace license."
    },
    "ticker": {
      "type": "string",
      "description": "Ticker to analyze, e.g. 'TSLA', '0700.HK'."
    },
    "period": {
      "type": "string",
      "description": "History window, e.g. '6mo', '1y'.",
      "default": "6mo"
    },
    "interval": {
      "type": "string",
      "description": "Candle interval, e.g. '1d'.",
      "default": "1d"
    },
    "lang": {
      "type": "string",
      "description": "Language for text labels, e.g. 'en', 'zh-HK'.",
      "default": "en"
    }
  },
  "required": [
    "ticker"
  ]
}

Get AI-structured event clusters from recent news: same-story headline clusters with entity/sentiment/quant-context fields and an AI-written narrative summary. Optionally scoped to one ticker; otherwise returns the latest cross-market feed. This is structured fact extraction, not republished article text, and never includes a directional trading signal or probability estimate.

{
  "type": "object",
  "properties": {
    "api_key": {
      "type": "string",
      "description": "XFINLAB Intelligence API key (X-API-Key). Omit if supplied via HTTP header instead."
    },
    "marketplace_license_key": {
      "type": "string",
      "description": "Optional: an mcp-marketplace.io license key for this listing's paid tier. If valid, upgrades a free XFINLAB API key's daily quota to Pro for this call. Omit if supplied via the X-Marketplace-License-Key header instead, or if not using a marketplace license."
    },
    "ticker": {
      "type": "string",
      "description": "Optional ticker to scope the feed to, e.g. 'MSFT'."
    },
    "limit": {
      "type": "integer",
      "description": "Max event clusters, 1-10.",
      "default": 5
    },
    "lang": {
      "type": "string",
      "description": "Language for the narrative summary.",
      "default": "en"
    }
  },
  "required": []
}

Get a cross-region global market snapshot ('World Engine'): macro indicators (GDP growth/inflation/unemployment, with source attribution -- world_bank/fred/ecb), filtered regional headlines, and FinBERT sentiment for each requested region, plus a top-level global headlines feed (GDELT). Regions: us, europe, japan, korea, china, hk, tw, sea, me, latam. No AI narrative, no directional signal -- structured real data only.

{
  "type": "object",
  "properties": {
    "api_key": {
      "type": "string",
      "description": "XFINLAB Intelligence API key (X-API-Key). Omit if supplied via HTTP header instead."
    },
    "marketplace_license_key": {
      "type": "string",
      "description": "Optional: an mcp-marketplace.io license key for this listing's paid tier. If valid, upgrades a free XFINLAB API key's daily quota to Pro for this call. Omit if supplied via the X-Marketplace-License-Key header instead, or if not using a marketplace license."
    },
    "regions": {
      "type": "string",
      "description": "Comma-separated region keys, e.g. 'us,hk,china'. Omit for all 10 regions."
    },
    "news_limit": {
      "type": "integer",
      "description": "Headlines per region, 1-20.",
      "default": 6
    },
    "include_sentiment": {
      "type": "boolean",
      "description": "Whether to run FinBERT sentiment on each region's headlines.",
      "default": true
    }
  },
  "required": []
}