apiUsage

Get your Hydromancer API usage statistics broken down by day and request type.

This endpoint returns your Hydromancer API usage.

POST Request

Field	Type	Description
type	string	Must be "apiUsage"
days	integer	Number of days to look back (optional, default 30)

cURL

curl -X POST https://api.hydromancer.xyz/info \
  -H "Authorization: Bearer $HYDROMANCER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "apiUsage",
    "days": 7
  }'

Python

import requests
import os

response = requests.post(
    'https://api.hydromancer.xyz/info',
    json={
        'type': 'apiUsage',
        'days': 7
    },
    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: 'apiUsage',
        days: 7
    }, {
        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
day	string	Date in YYYY-MM-DD format
request_type	string	Endpoint or request type name
total_requests	int	Total number of requests
success_requests	int	Number of successful requests
failure_requests	int	Number of failed requests
avg_processing_time_ms	float	Average processing time in milliseconds
tokens_consumed	int	Billable tokens consumed that day for this request type

Response

[
    {
        "day": "2026-03-16",
        "request_type": "allMids",
        "total_requests": 1,
        "success_requests": 1,
        "failure_requests": 0,
        "avg_processing_time_ms": 2.0,
        "tokens_consumed": 1
    },
    {
        "day": "2026-03-16",
        "request_type": "delegations",
        "total_requests": 5,
        "success_requests": 5,
        "failure_requests": 0,
        "avg_processing_time_ms": 0.0,
        "tokens_consumed": 5
    }
]