---
name: market-data
description: Access real-time and historical market data from TTC Box. Get tickers, funding rates, open interest, and volume across 30+ exchanges. Use when you need price data, market analysis, or trading signals.
license: Proprietary
compatibility: Designed for Claude Code (or similar products)
metadata:
  author: ttcbox
  version: "1.0"
  category: "market-data"
  emoji: "📊"
---

## Skill Files

| File                     | URL                                              |
| ------------------------ | ------------------------------------------------ |
| **SKILL.md** (this file) | `https://tetrac.xyz/skills/market-data/SKILL.md` |

## Overview

This skill provides access to market data endpoints:

1. **Tickers** - Real-time prices for spot and futures
2. **Funding Rates** - Perpetual futures funding rates
3. **Open Interest** - Market exposure data
4. **Volume** - Trading volume metrics and snapshots
5. **TTC Scanner** - Single-symbol analysis with trade signals
6. **News** - Market news and sentiment from Alpha Vantage
7. **Calendar** - Economic calendar events
8. **Insights** - LLM-powered market analysis via vector search
9. **Listings** - New token listing detection
10. **Quakes** - Earthquake/seismic events from USGS

---

## Get Tickers

Get real-time ticker data for all supported markets.

### Basic Request

```bash
curl https://tetrac.xyz/api/v1/markets/hybrid-tickers \
  -H "ttc-auth-token: YOUR_AUTH_TOKEN" \
  -H "ttc-public-key: YOUR_PUBLIC_KEY"
```

### Filter by Type

```bash
# Get only futures tickers
curl "https://tetrac.xyz/api/v1/markets/hybrid-tickers?type=futures" \
  -H "ttc-auth-token: YOUR_AUTH_TOKEN" \
  -H "ttc-public-key: YOUR_PUBLIC_KEY"

# Get only spot tickers
curl "https://tetrac.xyz/api/v1/markets/hybrid-tickers?type=spot" \
  -H "ttc-auth-token: YOUR_AUTH_TOKEN" \
  -H "ttc-public-key: YOUR_PUBLIC_KEY"
```

### Filter by Volume

```bash
# Get tickers with minimum $1M volume
curl "https://tetrac.xyz/api/v1/markets/hybrid-tickers?minimumVolume=1000000" \
  -H "ttc-auth-token: YOUR_AUTH_TOKEN" \
  -H "ttc-public-key: YOUR_PUBLIC_KEY"
```

### Filter by Price Change

```bash
# Get tickers up 5% or more
curl "https://tetrac.xyz/api/v1/markets/hybrid-tickers?up=5" \
  -H "ttc-auth-token: YOUR_AUTH_TOKEN" \
  -H "ttc-public-key: YOUR_PUBLIC_KEY"

# Get tickers down 5% or more
curl "https://tetrac.xyz/api/v1/markets/hybrid-tickers?down=5" \
  -H "ttc-auth-token: YOUR_AUTH_TOKEN" \
  -H "ttc-public-key: YOUR_PUBLIC_KEY"
```

### Filter by Symbol

```bash
# Get a single market by symbol
curl "https://tetrac.xyz/api/v1/markets/hybrid-tickers?symbol=BTCUSDT" \
  -H "ttc-auth-token: YOUR_AUTH_TOKEN" \
  -H "ttc-public-key: YOUR_PUBLIC_KEY"

# Combine with type filter
curl "https://tetrac.xyz/api/v1/markets/hybrid-tickers?symbol=ETHUSDT&type=futures" \
  -H "ttc-auth-token: YOUR_AUTH_TOKEN" \
  -H "ttc-public-key: YOUR_PUBLIC_KEY"
```

### Filter by Exchange

```bash
curl "https://tetrac.xyz/api/v1/markets/hybrid-tickers?exchange=binance" \
  -H "ttc-auth-token: YOUR_AUTH_TOKEN" \
  -H "ttc-public-key: YOUR_PUBLIC_KEY"
```

### Query Parameters

| Parameter       | Type   | Description                              |
| --------------- | ------ | ---------------------------------------- |
| `symbol`        | string | Exact symbol match (e.g., `BTCUSDT`)     |
| `type`          | string | `spot` or `futures`                      |
| `minimumVolume` | number | Minimum 24h volume in USD                |
| `maximumPrice`  | number | Maximum price filter                     |
| `minimumPrice`  | number | Minimum price filter                     |
| `up`            | number | Minimum % gain (e.g., `5` for +5%)       |
| `down`          | number | Minimum % loss (e.g., `5` for -5%)       |
| `exchange`      | string | Filter by exchange name (binance, bybit) |

### Response Example

```json
{
  "success": true,
  "data": {
    "spot": {
      "data": [
        {
          "symbol": "BTCUSDT",
          "lastPrice": "97500.00",
          "priceChange": "2500.00",
          "priceChangePercent": "2.63",
          "highPrice": "98500.00",
          "lowPrice": "94500.00",
          "volume": "50000",
          "quoteVolume": "4850000000",
          "openPrice": "95000.00",
          "bidPrice": "97495.00",
          "askPrice": "97505.00",
          "source": "binance",
          "sources": ["binance", "bybit", "phemex"]
        }
      ]
    },
    "futures": {
      "data": [
        {
          "symbol": "BTCUSDT",
          "lastPrice": "97520.00",
          "priceChange": "2520.00",
          "priceChangePercent": "2.65",
          "highPrice": "98520.00",
          "lowPrice": "94520.00",
          "volume": "125000",
          "quoteVolume": "12125000000",
          "openPrice": "95000.00",
          "funding": "0.0001",
          "nextFunding": 1738454400000,
          "openInterest": 12500000000,
          "source": "binance"
        }
      ]
    }
  },
  "cached": true,
  "timestamp": 1738435234567
}
```

---

## Get Funding Rates

Get funding rates across all exchanges.

### All Funding Rates

```bash
curl https://tetrac.xyz/api/v1/markets/funding-rates \
  -H "ttc-auth-token: YOUR_AUTH_TOKEN" \
  -H "ttc-public-key: YOUR_PUBLIC_KEY"
```

### Specific Symbol

```bash
curl "https://tetrac.xyz/api/v1/markets/funding-rates?symbol=BTCUSDT" \
  -H "ttc-auth-token: YOUR_AUTH_TOKEN" \
  -H "ttc-public-key: YOUR_PUBLIC_KEY"
```

### Response Example

```json
{
  "success": true,
  "data": [
    {
      "exchange": "binance",
      "symbol": "BTCUSDT",
      "fundingRate": 0.0001,
      "nextFundingTime": 1738454400000,
      "timestamp": 1738435234567,
      "openInterest": 12500000000
    },
    {
      "exchange": "bybit",
      "symbol": "BTCUSDT",
      "fundingRate": 0.00012,
      "nextFundingTime": 1738454400000,
      "timestamp": 1738435234567
    }
  ]
}
```

---

## Get Open Interest

```bash
curl https://tetrac.xyz/api/v1/markets/open-interest \
  -H "ttc-auth-token: YOUR_AUTH_TOKEN" \
  -H "ttc-public-key: YOUR_PUBLIC_KEY"
```

---

## Get Volume Snapshot

Get real-time per-exchange volume, open interest, TVL, and per-market breakdowns.

```bash
curl https://tetrac.xyz/api/v1/markets/volume-snapshot \
  -H "ttc-auth-token: YOUR_AUTH_TOKEN" \
  -H "ttc-public-key: YOUR_PUBLIC_KEY"
```

### Filter by Exchange

```bash
curl "https://tetrac.xyz/api/v1/markets/volume-snapshot?exchange=variational" \
  -H "ttc-auth-token: YOUR_AUTH_TOKEN" \
  -H "ttc-public-key: YOUR_PUBLIC_KEY"
```

### Query Parameters

| Parameter  | Type   | Description                                           |
| ---------- | ------ | ----------------------------------------------------- |
| `exchange` | string | Filter by exchange name (e.g., `variational`, `dydx`) |

---

## TTC Scanner ( TA Analysis)

Scan a single market symbol through technical analysis. Returns swing-based setups, scoring, and a composite trade signal with entry, stop-loss, and up to 3 take-profit levels.

### Basic Request

```bash
curl "https://tetrac.xyz/api/v1/markets/ttc-scanner?symbol=BTCUSDT" \
  -H "ttc-auth-token: YOUR_AUTH_TOKEN" \
  -H "ttc-public-key: YOUR_PUBLIC_KEY"
```

### Custom Timeframe & Parameters

```bash
curl "https://tetrac.xyz/api/v1/markets/ttc-scanner?symbol=ETHUSDT&timeframe=4h&bars=500&swingStrength=15" \
  -H "ttc-auth-token: YOUR_AUTH_TOKEN" \
  -H "ttc-public-key: YOUR_PUBLIC_KEY"
```

### Query Parameters

| Parameter       | Type   | Required | Default | Description                                         |
| --------------- | ------ | -------- | ------- | --------------------------------------------------- |
| `symbol`        | string | Yes      | —       | Market symbol (e.g., `BTCUSDT`)                     |
| `timeframe`     | string | No       | `1h`    | Kline interval (e.g., `1m`, `5m`, `1h`, `4h`, `1d`) |
| `bars`          | number | No       | `1000`  | Number of bars to analyze (max 1000)                |
| `swingStrength` | number | No       | `10`    | Lookback period for swing detection                 |

### Response Example

```json
{
  "success": true,
  "timestamp": 1738435234567,
  "params": {
    "symbol": "BTCUSDT",
    "timeframe": "1h",
    "bars": 1000,
    "swingStrength": 10
  },
  "data": {
    "symbol": "BTCUSDT",
    "price": 97500.0,
    "scoring": {
      "currentPrice": 97500.0,
      "long": { "score": 72 },
      "short": { "score": 35 }
    },
    "signal": {
      "direction": "LONG",
      "strength": 68,
      "confidence": "MEDIUM",
      "entry": 97500.0,
      "stopLoss": 95200.0,
      "takeProfit1": 99000.0,
      "takeProfit2": 101500.0,
      "takeProfit3": 104000.0,
      "riskRewardRatio": 2.85,
      "reasoning": "bull composite 68.2 (score 72, R/R 2.85) vs opposite 38.1"
    }
  }
}
```

### Signal Fields

| Field             | Type   | Description                                        |
| ----------------- | ------ | -------------------------------------------------- |
| `direction`       | string | `LONG`, `SHORT`, or `NEUTRAL`                      |
| `strength`        | number | Composite score (0–100)                            |
| `confidence`      | string | `HIGH` (≥70), `MEDIUM` (≥50), or `LOW` (<50)       |
| `entry`           | number | Current price as entry point                       |
| `stopLoss`        | number | Suggested stop-loss level (null if no clear level) |
| `takeProfit1–3`   | number | Up to 3 take-profit targets (null if unavailable)  |
| `riskRewardRatio` | number | Risk/reward ratio of the chosen direction          |
| `reasoning`       | string | Human-readable explanation of the signal           |

---

## Get News

Get market news and sentiment from Alpha Vantage.

```bash
curl https://tetrac.xyz/api/v1/markets/news \
  -H "ttc-auth-token: YOUR_AUTH_TOKEN" \
  -H "ttc-public-key: YOUR_PUBLIC_KEY"
```

### Response Example

```json
{
  "success": true,
  "data": {
    "items": [
      {
        "title": "Bitcoin Hits New High...",
        "url": "https://...",
        "time_published": "20260328T120000",
        "summary": "...",
        "source": "Reuters",
        "impact_score": 85,
        "sentiment": "Positive"
      }
    ],
    "timestamp": 1738435234567
  }
}
```

---

## Get Economic Calendar

Get economic calendar events from Financial Modeling Prep.

### Basic Request

```bash
curl https://tetrac.xyz/api/v1/markets/calendar \
  -H "ttc-auth-token: YOUR_AUTH_TOKEN" \
  -H "ttc-public-key: YOUR_PUBLIC_KEY"
```

### Filter by Date Range and Impact

```bash
curl "https://tetrac.xyz/api/v1/markets/calendar?from=2026-03-01&to=2026-03-31&impact=High" \
  -H "ttc-auth-token: YOUR_AUTH_TOKEN" \
  -H "ttc-public-key: YOUR_PUBLIC_KEY"
```

### Query Parameters

| Parameter | Type   | Description                    |
| --------- | ------ | ------------------------------ |
| `country` | string | Filter by country              |
| `impact`  | string | `Low`, `Medium`, or `High`     |
| `search`  | string | Text search across event names |
| `from`    | string | Start date (YYYY-MM-DD)        |
| `to`      | string | End date (YYYY-MM-DD)          |

---

## Get Market Insights

LLM-powered market analysis using vector search on ticker data.

```bash
curl -X POST https://tetrac.xyz/api/v1/markets/insights \
  -H "ttc-auth-token: YOUR_AUTH_TOKEN" \
  -H "ttc-public-key: YOUR_PUBLIC_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Which altcoins are showing the strongest momentum?",
    "analysisType": "analysis",
    "limit": 10
  }'
```

### Request Body

| Field          | Type   | Required | Default   | Description                            |
| -------------- | ------ | -------- | --------- | -------------------------------------- |
| `query`        | string | Yes      | —         | Natural language query                 |
| `analysisType` | string | No       | `summary` | `summary`, `analysis`, or `report`     |
| `limit`        | number | No       | `10`      | Number of matching tickers to consider |

---

## Get New Listings

Track new market listings by comparing submitted tickers against known symbols.

```bash
# GET — endpoint info
curl https://tetrac.xyz/api/v1/markets/listings \
  -H "ttc-auth-token: YOUR_AUTH_TOKEN" \
  -H "ttc-public-key: YOUR_PUBLIC_KEY"
```

The POST method accepts an array of ticker data and returns newly detected symbols.

---

## Get Quakes

Earthquake/seismic event data from USGS (significant events in the last 24 hours).

```bash
curl https://tetrac.xyz/api/v1/markets/quakes \
  -H "ttc-auth-token: YOUR_AUTH_TOKEN" \
  -H "ttc-public-key: YOUR_PUBLIC_KEY"
```

Returns a GeoJSON FeatureCollection with magnitude, location, tsunami warnings, and alert levels.

---

## Get Swap Volume History

Get historical daily swap volume (last 30 days).

```bash
curl https://tetrac.xyz/api/v1/markets/swap-volume \
  -H "ttc-auth-token: YOUR_AUTH_TOKEN" \
  -H "ttc-public-key: YOUR_PUBLIC_KEY"
```

---

## Supported Exchanges

**29 Supported Exchanges:**

CEX Perps

- Aevo
- AscendEX
- Binance
- BingX
- Bitget
- BitMEX
- BloFin
- Bybit
- KuCoin
- MEXC
- OKX
- Phemex
- Woox

DEX Perps

- Apex
- AsterDex
- dYdX
- Flash
- GRVT
- Hyperliquid
- Lighter
- Orderly Network
- Pacifica
- Paradex
- Propr
- Reya
- Variational
- Vest

---

## Rate Limits

| Action            | Default | High Karma (1000+) |
| ----------------- | ------- | ------------------ |
| Market Data Reads | 10/sec  | 50/sec             |

---

## Next Steps

- Learn [trading operations](https://tetrac.xyz/skills/trading/SKILL.md)
- Set up [x402 agent payments](https://tetrac.xyz/skills/x402-agent-payments/SKILL.md)

---

**Full API Documentation:** https://tetrac.xyz/docs/api