userFunding

Get a users' funding payment history

Get a users' funding payment history.

Data available from 28-07-2025

POST Request

Field	Type	Description
type	string	Must be "userFunding"
user	string	Ethereum address (0x-prefixed, 42 characters)
startTime	int	Start time in ms (inclusive)
endTime	int	End time in ms (optional)

cURL

curl -X POST https://api.hydromancer.xyz/info \
  -H "Authorization: Bearer $HYDROMANCER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "userFunding",
    "user": "0x0000000000000000000000000000000000000000",
    "startTime": 0
  }'

Python

import requests
import os

response = requests.post(
    'https://api.hydromancer.xyz/info',
    json={
        'type': 'userFunding',
        'user': '0x0000000000000000000000000000000000000000',
        'startTime': 0
    },
    headers={
        'Authorization': f'Bearer {os.environ.get("HYDROMANCER_API_KEY")}',
        'Content-Type': 'application/json'
    }
)

print(response.json())

Javascript

import axios from 'axios';

try {
    const response = await axios.post('https://api.hydromancer.xyz/info', {
        type: 'userFunding',
        user: '0x0000000000000000000000000000000000000000',
        startTime: 0
    }, {
        headers: {
            'Authorization': `Bearer ${process.env.HYDROMANCER_API_KEY}`,
            'Content-Type': 'application/json'
        }
    });

    console.log(response.data);
} catch (error) {
    console.error('Error:', error.message);
}

---

Response Fields

Field	Type	Description
time	int	Timestamp (ms)
hash	string	Transaction hash
delta	object	Funding payment details
delta.type	string	Always "funding"
delta.coin	string	Asset symbol
delta.usdc	string	USDC amount of funding payment
delta.szi	string	Position size at time of funding
delta.fundingRate	string	Funding rate applied
delta.nSamples	int	Number of samples (null if not applicable)

Response

[
    {
        "time": 1754064000066,
        "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
        "delta": {
            "type": "funding",
            "coin": "BTC",
            "usdc": "0.014419",
            "szi": "-0.01",
            "fundingRate": "0.0000125",
            "nSamples": null
        }
    }
]