fundingRates

Stream per-coin funding rates. Broadcasts once per hour when funding is applied.

New endpoint - this endpoint is not a part of original Hyperliquid API and is added by us for builder convenience.

Broadcasts the funding rate for every coin once per hour (~290 coins per event). Clients can calculate per-user funding payments as funding_rate * position_size.

Subscribe

{
    "method": "subscribe",
    "subscription": {
        "type": "fundingRates"
    }
}

Unsubscribe

{
    "method": "unsubscribe",
    "subscription": {
        "type": "fundingRates"
    }
}

Update data format

One message per hour containing all coins and their funding rates for that period.

{
    "type": "fundingRates",
    "seq": 1,
    "cursor": "500:1704067200000",
    "data": {
        "timestamp": 1704067200000,
        "rates": [
            { "coin": "BTC", "funding_rate": "0.0000125" },
            { "coin": "ETH", "funding_rate": "-0.0000638576" },
            { "coin": "SOL", "funding_rate": "0.0000125" },
            { "coin": "hyna:BTC", "funding_rate": "-0.0000373477" },
            { "coin": "xyz:GOLD", "funding_rate": "0.0000067899" }
        ]
    }
}

Field reference

Field	Type	Description
timestamp	number	Block timestamp when funding was applied (milliseconds since epoch)
rates	array	Array of per-coin funding rate objects
rates[].coin	string	Coin/market name, including DEX prefix (e.g. "ETH", "hyna:BTC", "xyz:GOLD")
rates[].funding_rate	string	Funding rate as a decimal string with full precision (e.g. "0.0000125", "-0.0007643369")

Examples

Javascript

const WebSocket = require('ws');

const ws = new WebSocket(`wss://api.hydromancer.xyz/ws?token=${process.env.HYDROMANCER_API_KEY}`);

ws.on('message', (data) => {
    const msg = JSON.parse(data);

    if (msg.type === 'connected') {
        ws.send(JSON.stringify({
            method: 'subscribe',
            subscription: {
                type: 'fundingRates'
            }
        }));
    } else if (msg.type === 'ping') {
        ws.send(JSON.stringify({ type: 'pong' }));
    } else if (msg.type === 'fundingRates') {
        console.log(`Funding rates at ${new Date(msg.data.timestamp).toISOString()}: ${msg.data.rates.length} coins`);
        for (const { coin, funding_rate } of msg.data.rates) {
            console.log(`  ${coin}: ${funding_rate}`);
        }
    }
});

Python

Common errors

1. Connection timeout - Respond to ping messages

2. Invalid API key