---
title: "Scan Hyperliquid funding rates for arb opportunities"
method: GET
path: "/v1/agent/futures/scan-funding"
tags: ["Research"]
---

# Scan Hyperliquid funding rates for arb opportunities

`GET /v1/agent/futures/scan-funding`

## Request

- Base URL: `https://www.farmdash.one/api`
- URL: `https://www.farmdash.one/api/v1/agent/futures/scan-funding`
- Auth: one of:
  - HTTP bearer
  - none

Returns current and predicted funding rates across all Hyperliquid perp
markets. Cross-references with Binance and Bybit to identify arbitrage.
Scout: top 3 with encrypted rates. Pioneer/Syndicate: full data.

## Headers

- `X-ClawHub-Skill` string

## Response `200`

Funding rate scan

- ScanFundingResponse
  - `ok` boolean
  - `tier` 'scout' | 'pioneer' | 'syndicate'
  - `arbOpportunities` FundingAnalysis[]
    - `coin` string
    - `fundingRate` number
    - `annualizedRate` number
    - `predictedRate` number
    - `crossVenueDelta` number
    - `premium` number
    - `openInterest` number
    - `isArbOpportunity` boolean
    - `arbDirection` 'long_spot_short_perp' | 'short_spot_long_perp' | 'null', nullable
  - `highFunding` FundingAnalysis[]
    - `coin` string
    - `fundingRate` number
    - `annualizedRate` number
    - `predictedRate` number
    - `crossVenueDelta` number
    - `premium` number
    - `openInterest` number
    - `isArbOpportunity` boolean
    - `arbDirection` 'long_spot_short_perp' | 'short_spot_long_perp' | 'null', nullable
  - `totalScanned` integer
  - `upgradeMessage` string
  - `timestamp` integer
  - `warnings` DustStormWarning[]
    - `kind` 'dust_storm', required
    - `message` string, required

## Other responses

- `402`: Free-tier limit exceeded — x402 payment required
- `429`: Rate limit exceeded
- `502`: Typed Hyperliquid funding provider degradation

---

[API](https://skmtc.dev/farmdash/apis/farmdash-agent-api.md) · [All operations](https://skmtc.dev/farmdash/apis/farmdash-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/farmdash/apis/farmdash-agent-api/revisions/96310281f58c?raw)