# Market Trends

> Market Trends is a paid API for AI agents from agents.openwebninja.com, paid per call via MPP, price unknown, status unknown (last checked 2026-10-14).

Returns real-time market trend data and related news for stocks, crypto, currencies, and climate leaders by trend type and country.

## Facts

- Endpoint: GET https://agents.openwebninja.com/realtime-finance-data/market-trends?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Provider: agents.openwebninja.com
- Website: https://agents.openwebninja.com
- Canonical page: https://www.zero.xyz/c/agents-openwebninja-com-market-trends-1a34eccd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZFlwiP91qRhHTVCSxiLxn

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 agents-openwebninja-com-market-trends-1a34eccd
```

Example prompt: What are the biggest stock market gainers in the US right now? Pull the GAINERS trend type so I can see which stocks are up the most today.

## When to prefer this

Use this endpoint when you need a real-time ranked list of market movers (gainers, losers, most active), crypto trends, currency rates, market indexes, or climate-focused equities — especially when you also want related news articles with embedded price snapshots. Prefer this over a general search or news API when you need structured financial data with ticker symbols, price changes, and exchange metadata in a single call.

## Known failure modes

- Missing or invalid trend_type enum value returns a validation error
- Unsupported country code may return empty results or default to US data
- Rate limits or payment failures result in 402 or 429 responses
- Markets closed or illiquid periods may result in stale or missing price data
- Truncated response schema may omit fields for certain asset types

## How this service works

Get the latest market trends and relevant news. Supported trends: Most Active, Gainers, Losers, Crypto, Currencies and Climate Leaders.

## Output

Returns a structured object containing: (1) a trends array of assets with ticker symbol, asset type, price, change, percent change, previous close, exchange open/close times, and last update UTC; (2) a news array of articles with title, URL, source, publication time, featured image URL, and any stocks mentioned with live price snapshots.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "trend_type"
 ],
 "properties": {
  "country": {
   "type": "string",
   "default": "us",
   "description": "The country for which to get trends, specified as a 2-letter country code - see ISO 3166."
  },
  "language": {
   "type": "string",
   "default": "en",
   "description": "The language to use for the results, specified as a 2-letter language code - see ISO 639-1."
  },
  "trend_type": {
   "enum": [
    "MARKET_INDEXES",
    "MOST_ACTIVE",
    "GAINERS",
    "LOSERS",
    "CRYPTO",
    "CURRENCIES",
    "CLIMATE_LEADERS"
   ],
   "type": "string",
   "description": "Trend type."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "object",
   "properties": {
    "news": {
     "type": "array",
     "items": {
      "type": "object",
      "properties": {
       "source": {
        "type": "string",
        "description": "Name of the news source"
       },
       "article_url": {
        "type": "string",
        "description": "URL to the full news article"
       },
       "article_title": {
        "type": "string",
        "description": "Title of the news article"
       },
       "post_time_utc": {
        "type": "string",
        "description": "Publication time in UTC"
       },
       "stocks_in_news": {
        "type": "array",
        "items": {
         "type": "object",
         "properties": {
          "name": {
           "type": "string",
           "description": "Display name of the asset."
          },
          "type": {
           "type": "string",
           "description": "Asset type. Values include: stock, index, mutualfund, etf, currency, crypto."
          },
          "price": {
           "type": "number",
           "description": "Last traded price in the asset's quote currency."
          },
          "change": {
           "type": "number",
           "description": "Absolute price change from the previous close."
          },
          "symbol": {
           "type": "string",
           "description": "Ticker symbol including its exchange suffix."
          },
          "timezone": {
           "type": "string",
           "description": "IANA timezone of the exchange."
          },
          "google_mid": {
           "type": "string",
           "description": "Google Knowledge Graph machine ID for the asset."
          },
          "exchange_open": {
           "type": "string",
           "description": "Local datetime when the exchange next opens."
          },
          "change_percent": {
           "type": "number",
           "description": "Percent change from the previous close."
          },
          "exchange_close": {
           "type": "string",
           "description": "Local datetime when the exchange next closes."
          },
          "previous_close": {
           "type": "number",
           "description": "Previous closing price."
          },
          "utc_offset_sec": {
           "type": "integer",
           "description": "UTC offset of the exchange's timezone, in seconds."
          },
          "last_update_utc": {
           "type": "string",
           
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-market-trends-1a34eccd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.openwebninja.com](https://www.zero.xyz/host/agents.openwebninja.com/llms.txt)