fundingPayments

Get all funding payments for the most recent hour across all markets and users as a compressed snapshot.

Overview

The fundingPayments endpoint returns all funding payments from the most recent funding hour across every market and user on Hyperliquid. Data is grouped by coin and compressed using msgpack + zstd.

There are two endpoints:

1. Metadata Endpoint (Fast): Check the current snapshot timestamp and event count

2. Snapshot Endpoint (Heavy): Download the full funding payment data

Funding Payment Metadata (Fast)

• Endpoint: POST /info

• Purpose: Check the current snapshot timestamp and size without downloading data

Request

{
  "type": "fundingPaymentTimestamp"
}

Response

{
  "time": 1709251200000,
  "count": 198432
}

Field	Description
time	Funding hour timestamp in milliseconds
count	Total number of funding payment events

Funding Payments Snapshot (Heavy)

• Endpoint: POST /info

• Purpose: Download the full funding payment snapshot

• Response: zstd-compressed msgpack binary

Request

{
  "type": "fundingPayments"
}

Response Headers

Header	Value
Content-Type	application/zstd
x-payload-format	msgpack
x-snapshot-time	Funding hour timestamp (ms)
x-snapshot-count	Total event count

Data Format

The response body is a zstd-compressed msgpack binary. After decompressing (zstd) and decoding (msgpack), the payload is an array:

[
  1709251200000,
  [
    ["BTC", "0.0001", ["0xabc...", "0xdef..."], ["12.345", "-5.678"], ["1.5", "-0.8"]],
    ["ETH", "-0.00005", ["0x123..."], ["-2.1"], ["10.0"]]
  ]
]

Index	Description
[0]	Funding hour timestamp in milliseconds
[1]	Array of per-coin funding data
[1][][0]	Coin name (e.g., "BTC", "ETH")
[1][][1]	Funding rate for this coin (string, same for all users)
[1][][2]	User addresses (parallel array)
[1][][3]	Funding payment amounts per user (string, parallel with [2])
[1][][4]	Position sizes per user (string, parallel with [2])

All numeric values (rate, amounts, sizes) are decimal strings for exact precision.

Implementation Examples

Note: Set HYDROMANCER_API_KEY in your .env file.

Python

import asyncio
import io
import aiohttp
import zstandard as zstd
import msgpack
import os
from dotenv import load_dotenv

load_dotenv()


async def get_funding_payments():
    base_url = os.getenv("HYDROMANCER_API_URL", "https://api.hydromancer.xyz")
    api_key = os.getenv("HYDROMANCER_API_KEY")
    headers = {
        "Content-Type": "application/json",
        "Authorization": f"Bearer {api_key}",
    }

    async with aiohttp.ClientSession() as session:
        # 1. Check metadata first
        async with session.post(
            f"{base_url}/info",
            json={"type": "fundingPaymentTimestamp"},
            headers=headers,
        ) as resp:
            meta = await resp.json()
            print(f"Snapshot time: {meta['time']}, events: {meta['count']}")

        # 2. Download snapshot
        async with session.post(
            f"{base_url}/info",
            json={"type": "fundingPayments"},
            headers=headers,
        ) as resp:
            compressed = await resp.read()
            print(f"Downloaded {len(compressed)} bytes")

            # Decompress and decode
            dctx = zstd.ZstdDecompressor()
            raw = dctx.stream_reader(io.BytesIO(compressed)).read()
            data = msgpack.unpackb(raw, raw=False)

            timestamp, markets = data[0], data[1]
            print(f"Funding hour: {timestamp}")
            print(f"Markets: {len(markets)}")

            for market in markets:
                coin, rate, addresses, amounts, sizes = market
                print(f"  {coin}: rate={rate}, users={len(addresses)}")


asyncio.run(get_funding_payments())

JavaScript