# PayPerByte Perp Positioning Snapshot

> PayPerByte Perp Positioning Snapshot is a paid API for AI agents from x402.payperbyte.io, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-13).

Returns a live perpetual swap positioning snapshot for requested assets, including per-venue legs, funding rates, open interest, and weighted aggregate metrics.

## Facts

- Endpoint: POST https://x402.payperbyte.io/feeds/positioning-snapshot
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/payperbyte-perp-positioning-snapshot-ce71ccbd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9ayCrFcXyPDwUW-v2PVYZ

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 payperbyte-perp-positioning-snapshot-ce71ccbd -d '<json body>'
```

Example prompt: Pull the latest perp positioning snapshot for BTC and ETH — I want to see open interest, funding rates, and weighted aggregates broken down by venue.

## When to prefer this

Use this endpoint when you need a real-time, cross-venue perpetual swap positioning snapshot with funding rates, open interest, and weighted aggregates for one or more crypto assets. Prefer this over individual exchange APIs when you want a unified, aggregated view across multiple venues (Hyperliquid, dYdX, Aevo) in a single call. Ideal for agents doing market positioning analysis, funding rate arbitrage detection, or risk monitoring.

## Known failure modes

- Invalid or unsupported asset symbol returns an error
- Missing required asset list in request body results in 400 error
- Payment not included or insufficient USDC triggers x402 payment-required response
- Venue data temporarily unavailable may result in partial snapshot or stale data warning
- Rate limiting if too many requests in a short window

## How this service works

Cross-venue perp positioning (funding + open interest) from Hyperliquid, dYdX v4, Aevo; raw fields, abstains honestly where a venue lacks data.

## Output

A structured snapshot containing per-venue perpetual swap legs (e.g. Hyperliquid, dYdX, Aevo), funding rates for each venue, open interest figures, and weighted aggregate metrics across all requested assets.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "assets": {
   "type": "array",
   "items": {
    "type": "string",
    "pattern": "^[A-Za-z0-9]{1,10}$"
   },
   "maxItems": 10,
   "description": "Subset of the configured asset set to snapshot (default: all configured — BTC, ETH, SOL, ARB, AVAX)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "feed": "positioning-snapshot"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/payperbyte-perp-positioning-snapshot-ce71ccbd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.payperbyte.io](https://www.zero.xyz/host/x402.payperbyte.io/llms.txt)