# TrollBridge Perp Basis & Funding Rate

> TrollBridge Perp Basis & Funding Rate is a paid API for AI agents from mini-tollbooth.onrender.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-11).

Returns the perpetual futures basis spread (mark vs oracle price) and funding rate for a given trading pair on Hyperliquid

## Facts

- Endpoint: GET https://mini-tollbooth.onrender.com/perp-basis?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/trollbridge-perp-basis-funding-rate-84ac3739
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_esGnerzoXAUmVY4VLLpvk

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 trollbridge-perp-basis-funding-rate-84ac3739
```

Example prompt: What's the current perp basis and funding rate for BTCUSDT on Hyperliquid — show me the mark vs oracle spread in bps and the annualized funding APR.

## When to prefer this

Use this endpoint when you need real-time perpetual futures basis and funding rate data specifically from Hyperliquid, particularly for cash-and-carry arbitrage analysis, monitoring funding cost on open positions, or gauging market sentiment via the mark-oracle spread. Prefer this over generic market data APIs when Hyperliquid-specific data is required and when funding APR and basis bps are needed in a single call.

## Known failure modes

- Invalid or unsupported symbol returns an error — use formats like 'BTCUSDT' or 'ETHUSDT'
- Hyperliquid data feed unavailability may cause stale or missing data
- Missing required 'symbol' query parameter returns a 400-level error
- Network timeout from Hyperliquid upstream causes delayed or failed response

## How this service works

The insurance booth for AI agents, with Mini's Agent Supply Store on the side of the road. One hundred checkpoints: pre-transaction safety lanes (honeypot, approval-risk, rug-score, receipt-check, tx-dryrun, permit-scan, airdrop-verdict, deployer-history, wallet-watch, secret-scan at $0.02 USDC per call; the protection tier — /contract-check, /approval-screen, /tx-plain-english, /honeypot-check, /tx-simulate, /redteam, /skill-scan, /verdict, /egress-audit, /tool-gate, /airlock, /repo-scan, /prove, /task-scope — at $0.10; the one-call /shield don't-get-rugged screen at $0.25; the full /preflight bundle at $0.05), bounty intel (bounties, fresh, verdicts, deadlines, sweepstakes, opportunities) at $0.02 USDC per call, trader intel (/prices and /quant at $0.02; /enrich and /token-check at $0.05; /contract-check and /honeypot-check at $0.10; /sec-facts at $0.05), market intel (/markets and /search at $0.05; /grants at $0.02), DeFi intel (/yields and /new-pairs at $0.05; /gas and /defi at $0.02), AI intel (/models at $0.02), agent-ops intel (/prompt-cost, /model-picks, /rpc-speed, /terms-tldr, /scrape, /gigs, /retry-verify, /idempotency, /verify-independent at $0.02; /site-watch, /wallet-check, /code-run, /regulatory-pack, /sage, /cron-watch, /caveat-check, /tripwire, /escrow, /trust, /bridge-fees, /dao-votes, /dev-activity, /dex-arb, /dydx-perps, /funding-rates, /gas-predict, /hack-tracker, /long-short-ratio, /lp-yields, /mev-scan, /open-interest, /perp-basis, /polymarket-odds, /rwa-watch, /sentiment, /stablecoin-flows, /tokenomics, /top-movers, /whale-watch, and /yield-stable at $0.05; /approval-screen, /tx-plain-english, /tx-simulate, and /task-scope at $0.10; /scam-scan deep scan at $5.00 or 30-day subscription at $30.00), supply store (/road-pack combo meal at $0.05; curated datasets, the /audit-prep pre-audit review, and the /prove-state symbolic-execution run at $1.00; the /audit AI-agent audit at $25.00). Every lane answers before money moves — heuristic verdicts, not audits. Don't get rugged.

## Output

Returns a JSON object with the base asset, venue (Hyperliquid), mark price, oracle price, raw premium, basis in basis points, funding rate per hour, annualized funding APR percentage, and maximum available leverage for the queried perpetual symbol.

## 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",
     "required": [],
     "properties": {
      "limit": {
       "type": "integer",
       "maximum": 200,
       "minimum": 1,
       "description": "Max items to return. Omit for the full feed."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "base": "BTC",
  "lane": "/perp-basis",
  "venue": "hyperliquid",
  "markPx": 85440,
  "symbol": "BTCUSDT",
  "premium": -0.0001860413,
  "basisBps": -1.33,
  "oraclePx": 85451.4,
  "description": "Perp basis & funding ($0.05) — Hyperliquid perp mark vs oracle spread plus funding rate.",
  "maxLeverage": 40,
  "fundingAprPct": 10.95,
  "fundingPerHour": 0.0000125
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/trollbridge-perp-basis-funding-rate-84ac3739/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mini-tollbooth.onrender.com](https://www.zero.xyz/host/mini-tollbooth.onrender.com/llms.txt)