# Agentshelf Perpetual Funding Rates

> Agentshelf Perpetual Funding Rates is a paid API for AI agents from agentshelf.syntexa.ch, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-30).

Fetches current perpetual futures funding rates for a single symbol or a fixed major asset list, aggregating across Hyperliquid, Binance USDT-M, OKX, and Bybit

## Facts

- Endpoint: POST https://agentshelf.syntexa.ch/v1/perp-funding-rates?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentshelf-perpetual-funding-rates-9aa455cd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AwAA-Lq-q7Kuiz0-cBmpw

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 agentshelf-perpetual-funding-rates-9aa455cd -d '<json body>'
```

Example prompt: What's the current perpetual futures funding rate for BTC across exchanges — include the next funding time if available?

## When to prefer this

Choose this endpoint when you need real-time perpetual funding rate data aggregated across multiple top-tier venues (Hyperliquid, Binance, OKX, Bybit) in a single call. Ideal for trading agents that need to compare cross-venue funding, identify arbitrage spreads, or monitor carry costs. Prefer it over single-exchange APIs when multi-venue coverage and fallback resilience matter.

## Known failure modes

- Symbol not found on any venue — returns empty or error response
- All venues geo-blocked from the server's region — returns no data
- Invalid symbol format — rejected with validation error
- Rate limit or upstream exchange downtime — partial or empty results
- Limit exceeds maximum of 10 — clamped or rejected

## How this service works

Call when an agent needs current perpetual funding for one symbol or a fixed major list. Tries Hyperliquid and Binance USDT-M futures, then OKX and Bybit. Includes next funding time and mark or index when the venue returns them. A geo-blocked venue is skipped. Send JSON {"symbol":"BTC"}. Exact $0.002 USDC on Base. Try unpaid POST /v1/sandbox/perp-funding-rates first.

## Output

Returns current perpetual funding rate(s) per venue, next funding timestamp, and optionally mark or index price where the exchange provides them. Results are scoped to whichever venues are accessible (geo-blocked venues are silently skipped). Single symbol or up to 10 major assets depending on input.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 10,
   "maximum": 10,
   "minimum": 1,
   "description": "How many majors to return when symbol is omitted. Example: 2. Default 10. At most 10. Ignored when symbol is set."
  },
  "symbol": {
   "type": "string",
   "examples": [
    "BTC"
   ],
   "description": "Perpetual base asset. Example: BTC. BTCUSDT and BTC-USDT are accepted. Omit it for the fixed major list, not a volume ranking."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentshelf-perpetual-funding-rates-9aa455cd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentshelf.syntexa.ch](https://www.zero.xyz/host/agentshelf.syntexa.ch/llms.txt)