# SYNTHORA Perps Snapshot

> SYNTHORA Perps Snapshot is a paid API for AI agents from perps.hergertsynthora.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-13).

Returns a live Hyperliquid perpetual futures snapshot for one or multiple assets, including mark price, oracle price, funding rates, open interest, premium, and 24h volume.

## Facts

- Endpoint: POST https://perps.hergertsynthora.com/service
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/synthora-perps-snapshot-617a15f4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1tb4FOAmrAEnBXpkoOjkY

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 synthora-perps-snapshot-617a15f4 -d '<json body>'
```

Example prompt: Give me a live snapshot of BTC's perpetual futures on Hyperliquid — I need the mark price, oracle price, hourly funding rate with the 8h and APR breakdowns, open interest in USD, and include the recent funding history.

## When to prefer this

Choose this endpoint when you need a single-shot, real-time snapshot of Hyperliquid perpetual futures data — especially funding rates, open interest, and mark/oracle prices — without managing API keys. Ideal for trading agents that need to compare funding rates across assets, assess open interest, or monitor premium. Prefer this over generic market data APIs when Hyperliquid-specific data and Ed25519-signed integrity guarantees matter.

## Known failure modes

- Invalid or unknown asset symbol returns an error or empty result
- Limit out of range (outside 1-50) may return a validation error
- Payment failure via x402 results in 402 response before data is returned
- Hyperliquid upstream unavailability may cause stale or missing data
- Malformed request body returns a 400 error

## How this service works

SYNTHORA Perps Snapshot: live Hyperliquid perpetual futures snapshot per asset — mark price, oracle price, hourly funding rate (with 8h and APR derivations), open interest (USD), premium and 24h volume for 230+ perps, keyless. Complements the Open Interest oracle with the raw single-shot data a trading agent needs. Ed25519-signed. 0.002 USDC via x402 on Base. SYNTHORA.

## Output

Returns a JSON object with mark price, oracle price, hourly funding rate, derived 8h funding rate, annualized funding APR, open interest in USD, premium between mark and oracle, and 24h volume for the requested asset(s). When no asset is specified, returns the top assets ranked by open interest (up to 50). If history is enabled, includes the recent 8h funding rate history for the queried asset. Response is Ed25519-signed for integrity verification.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "asset": {
   "type": "string",
   "description": "Perp symbol e.g. BTC, ETH, SOL. Omit for top-10 by open interest"
  },
  "limit": {
   "type": "integer",
   "description": "Rows when no asset given (1-50, default 10)"
  },
  "history": {
   "type": "boolean",
   "description": "Include recent 8h funding history for the asset (default true)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "niche": "perps",
  "result": {
   "mark": 97500,
   "asset": "BTC",
   "oracle": 97490,
   "signed": "ed25519",
   "premium": 0.0001,
   "day_volume": 1850000000,
   "funding_rate": 0.0000125,
   "open_interest": 2260000000,
   "funding_apr_pct": 10.95
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/synthora-perps-snapshot-617a15f4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from perps.hergertsynthora.com](https://www.zero.xyz/host/perps.hergertsynthora.com/llms.txt)