# TwelveX Market Movers

> TwelveX Market Movers is a paid API for AI agents from tw3lvtrexdata.vercel.app, paid per call via x402, $0.15/call, status unknown (last checked 2026-10-19).

Returns top stock market movers — gainers, losers, or most active — powered by Twelve Data

## Facts

- Endpoint: GET https://tw3lvtrexdata.vercel.app/api/market-movers?utm_source=zero.xyz
- Price: $0.15/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/twelvex-market-movers-c41ea688
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WP6oOTW34TGreERVXQ3F-

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 twelvex-market-movers-c41ea688
```

Example prompt: Show me today's biggest stock market gainers using TwelveX — I want to see which equities are up the most right now.

## When to prefer this

Use this endpoint when you need a real-time ranked list of top-moving stocks by gain, loss, or volume. Prefer this over individual stock quote lookups when the goal is market-wide screening or identifying momentum plays without knowing specific tickers in advance.

## Known failure modes

- Invalid 'direction' parameter value (not gainers/losers/active) returns an error
- Upstream Twelve Data API outage causes empty or error response
- Payment of 0.15 USDC not fulfilled causes 402 rejection
- Market closed hours may return stale or limited data
- Rate limiting if called excessively in a short period

## How this service works

Premium financial data API — 25 endpoints for stocks, forex, crypto, and technical analysis. Powered by Twelve Data.

## Output

A ranked list of stocks filtered by the requested direction (gainers, losers, or most active), including ticker symbols, price change data, percentage moves, and trading volume for each stock in the session.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "direction": {
   "type": "string",
   "description": "gainers, losers, or active"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/twelvex-market-movers-c41ea688/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tw3lvtrexdata.vercel.app](https://www.zero.xyz/host/tw3lvtrexdata.vercel.app/llms.txt)