# ByKaranteli Solana Perps Hourly History

> ByKaranteli Solana Perps Hourly History is a paid API for AI agents from bykaranteli.com, paid per call via x402, $0.1/call, status unknown (last checked 2026-10-11).

Returns hourly time-series history of open interest, volume, funding rates, and mark prices across Solana perpetual trading venues (Pacifica, Phoenix, GM Trade, Velocity, Bullet) per market and metric.

## Facts

- Endpoint: GET https://bykaranteli.com/api/x402/solana-perps-history?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bykaranteli-solana-perps-hourly-history-5a8b6b38
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_iKBAtq7IqOjH62OD0B1iC

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 bykaranteli-solana-perps-hourly-history-5a8b6b38
```

Example prompt: Pull the hourly funding rate history for SOL on Pacifica and Phoenix from the past 7 days so I can compare how their rates have diverged.

## When to prefer this

Choose this endpoint when you need hourly granularity Solana-specific perp data across Pacifica, Phoenix, GM Trade, Velocity, or Bullet — especially for funding rates, open interest, volume, or mark prices. Prefer this over generic multi-exchange APIs when your analysis is focused on Solana-native perp venues and you need historical depth beyond what free tiers provide. Not suitable for Jupiter perp data or non-Solana venues.

## Known failure modes

- Invalid venue name returns empty results or error
- Invalid metric string returns error or empty set
- Date range outside available history (before 2024-09-25) returns no data
- Exceeding limit of 20000 returns a validation error
- Symbol not recognized by the specified venue returns empty results
- Missing payment header results in 402 Payment Required for historical data beyond 7 days

## How this service works

Hourly history of every Solana perp venue on the board but Jupiter (jupiter-history): Pacifica, Phoenix, GM Trade, Velocity and Bullet, per market and metric: one-sided open interest in USD (both sides on pool venues), 24h volume, hourly funding in percent of position size (empty where the venue publishes only an accumulator), mark, and Phoenix's raw funding accumulator; recorded from 2026-09-25. The free API returns the live board and seven days of one market.

## Output

A JSON array of time-series records, each containing timestamp, venue, symbol, and the requested metric value (e.g. oi_usd, funding_hourly_pct, volume_24h_usd, mark_usd, or funding_accumulator_raw). Records are hourly granularity. Up to 20,000 rows per call. The free tier returns only live board data and 7 days of history for one market; paid calls unlock full history from 2024-09-25.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "to": {
       "type": "string",
       "description": "iso, optional, default now"
      },
      "from": {
       "type": "string",
       "description": "iso, optional, default 30 days ago"
      },
      "limit": {
       "type": "number",
       "description": "number, default 1000, max 20000"
      },
      "venue": {
       "type": "string",
       "description": "string, optional: pacifica | phoenix | gmtrade | velocity | bullet"
      },
      "metric": {
       "type": "string",
       "description": "string, optional: oi_usd | oi_long_usd | oi_short_usd | volume_24h_usd | funding_hourly_pct | mark_usd | funding_accumulator_raw"
      },
      "symbol": {
       "type": "string",
       "description": "string, optional market as the venue names it, e.g. SOL, SOL-PERP, SOL-USD, USDCAD"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bykaranteli-solana-perps-hourly-history-5a8b6b38/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bykaranteli.com](https://www.zero.xyz/host/bykaranteli.com/llms.txt)