# Trader & Wallet Data

The Trader & Wallet Data endpoints provide comprehensive access to wallet information, user accounts, favorite tracking, and liquidation risk data. These endpoints allow you to retrieve detailed wallet analytics, manage claimed accounts, track favorite positions and accounts, and monitor liquidation risks across different market segments.

### Get Wallets

`/api/external/wallets`

{% hint style="success" %}
**Unique to HyperTracker Users**

This endpoint is exclusive to HyperTracker. It aggregates enriched wallet-level intelligence beyond what is available from the standard Hyperliquid API.
{% endhint %}

Retrieves a paginated list of Hyperliquid wallets with flexible filtering and sorting options. You can filter by wallet address, cohort segment IDs, and whether wallets currently have open positions.

Each wallet record includes key metrics such as total equity, perp equity, perp PnL, perp bias, open value, exposure ratio, unrealized PnL, liquidation proximity, earliest activity, display settings, verification status, and segment membership.

The endpoint can return up to 500 results per request. Lower limits usually result in faster response times.

<details>

<summary>Query Parameters</summary>

<table><thead><tr><th width="164.1129150390625">Parameter</th><th width="88.4578857421875">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>offset</code></td><td><code>number</code></td><td>Number of wallet records to skip before starting the returned list. Useful for pagination.</td></tr><tr><td><code>limit</code></td><td><code>number</code></td><td>Maximum number of wallet records to return. Maximum: 500.</td></tr><tr><td><code>order</code></td><td><code>array</code></td><td>Sort direction. Allowed values: asc, desc. Default: desc.</td></tr><tr><td><code>orderBy</code></td><td><code>string</code></td><td>Field used to sort the returned wallet records.<br>Allowed values: address, totalEquity, earliestActivityAt, perpPnl, perpEquity, perpBias, openValue, sumUpnl, closestLiqProgress, countOpenPositions, exposureRatio.</td></tr><tr><td><code>segmentIds</code></td><td><code>array</code></td><td>Filter by one or more cohort segment IDs. Use the Segment Legend to map segment names to IDs.</td></tr><tr><td><code>hasOpenPositions</code></td><td><code>boolean</code></td><td>Filter to wallets that currently have open positions.</td></tr><tr><td><code>address</code></td><td><code>string</code></td><td>Filter by wallet address.</td></tr></tbody></table>

</details>

Request Examples

{% tabs %}
{% tab title="Curl" %}

```
curl --request GET \
  --url 'https://ht-api.coinmarketman.com/api/external/wallets?offset=0&limit=50&order=desc&orderBy=perpPnl&hasOpenPositions=true' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Accept: application/json'
```

{% endtab %}

{% tab title="JavaScript" %}

```
const params = new URLSearchParams({
  offset: '0',
  limit: '50',
  order: 'desc',
  orderBy: 'perpPnl',
  hasOpenPositions: 'true'
});

const response = await fetch(
  `https://ht-api.coinmarketman.com/api/external/wallets?${params}`,
  {
    headers: {
      Authorization: 'Bearer YOUR_API_TOKEN',
      Accept: 'application/json'
    }
  }
);

if (!response.ok) {
  throw new Error(`Request failed: ${response.status} ${response.statusText}`);
}

const data = await response.json();

console.log(data);
```

{% endtab %}

{% tab title="Python" %}

```
import requests

response = requests.get(
    "https://ht-api.coinmarketman.com/api/external/wallets",
    params={
        "offset": 0,
        "limit": 50,
        "order": "desc",
        "orderBy": "perpPnl",
        "hasOpenPositions": "true",
    },
    headers={
        "Authorization": "Bearer YOUR_API_TOKEN",
        "Accept": "application/json",
    },
)

response.raise_for_status()

wallets = response.json()

print(wallets)
```

{% endtab %}
{% endtabs %}

Response

> **200 Success:** Returns a paginated list of wallet records matching the supplied filters.

<details>

<summary>Response Example</summary>

{% code expandable="true" %}

```
{
    "totalCount": 78620,
    "items": [
        {
            "xUserId": null,
            "displayName": null,
            "emoji": null,
            "verified": false,
            "segments": [
                16,
                12
            ],
            "address": "0xb01d9771789382992a9adf4315167775a66b220e",
            "favoriteCount": 0,
            "totalEquity": 2.797697,
            "earliestActivityAt": "2026-03-24T07:16:57.004Z",
            "perpPnl": -0.09119,
            "perpEquity": 2.77293,
            "exposureRatio": 3.81,
            "perpBias": 3.81,
            "openValue": 10.55901,
            "sumUpnl": 0.01666,
            "vault": null,
            "closestLiq": {
                "coin": "ETH",
                "progress": 0
            }
        },
        {
            "xUserId": null,
            "displayName": null,
            "emoji": null,
            "verified": false,
            "segments": [
                16,
                12
            ],
            "address": "0x1c50e6502e88ea324213183a55861123d756d6df",
            "favoriteCount": 0,
            "totalEquity": 2.059312,
            "earliestActivityAt": "2026-03-24T07:16:29.758Z",
            "perpPnl": -0.070688,
            "perpEquity": 2.045102,
            "exposureRatio": 10.05,
            "perpBias": 10.05,
            "openValue": 20.55114,
            "sumUpnl": -0.05539,
            "vault": null,
            "closestLiq": {
                "coin": "BTC",
                "progress": 3.08
            }
        },
        {
            "xUserId": null,
            "displayName": null,
            "emoji": null,
            "verified": false,
            "segments": [
                16,
                12
            ],
            "address": "0x60932b9ebaeb067c2f5cc46517bf43ea0012444c",
            "favoriteCount": 0,
            "totalEquity": 28.483178,
            "earliestActivityAt": "2026-03-24T07:16:15.629Z",
            "perpPnl": -1.74365,
            "perpEquity": 28.483178,
            "exposureRatio": 19.42,
            "perpBias": -19.42,
            "openValue": 553.0668,
            "sumUpnl": 0.36865,
            "vault": null,
            "closestLiq": {
                "coin": "SOL",
                "progress": 0
            }
        },
        {
            "xUserId": null,
            "displayName": null,
            "emoji": null,
            "verified": false,
            "segments": [
                16,
                11
            ],
            "address": "0xebb5abc1ca951b0d35aee05f7c1cf29e75e0d056",
            "favoriteCount": 0,
            "totalEquity": 46.619959,
            "earliestActivityAt": "2026-03-24T07:15:05.153Z",
            "perpPnl": 0.006039,
            "perpEquity": 46.619959,
            "exposureRatio": 3.96,
            "perpBias": -3.96,
            "openValue": 184.66032,
            "sumUpnl": 0.36562,
            "vault": null,
            "closestLiq": {
                "coin": "SOL",
                "progress": 0
            }
        },
        {
            "xUserId": null,
            "displayName": null,
            "emoji": null,
            "verified": false,
            "segments": [
                5,
                10
            ],
            "address": "0x999b1810e7b64a542ba248af0812f9bee431aa10",
            "favoriteCount": 0,
            "totalEquity": 761846.880287,
            "earliestActivityAt": "2026-03-24T07:12:05.065Z",
            "perpPnl": 55924.439487,
            "perpEquity": 761846.880287,
            "exposureRatio": 25.71,
            "perpBias": -25.71,
            "openValue": 19589999.8041,
            "sumUpnl": 75328.95199,
            "vault": null,
            "closestLiq": {
                "coin": "ETH",
                "progress": 0
            }
        },
        {
            "xUserId": null,
            "displayName": null,
            "emoji": null,
            "verified": false,
            "segments": [
                16,
                12
            ],
            "address": "0x134d1f3fc68403d59ae4a8752ef97a5cae0359aa",
            "favoriteCount": 0,
            "totalEquity": 15.588393,
            "earliestActivityAt": "2026-03-24T07:08:35.068Z",
            "perpPnl": -0.033107,
            "perpEquity": 0.367393,
            "exposureRatio": 32.91,
            "perpBias": 32.91,
            "openValue": 12.0905,
            "sumUpnl": -0.0295,
            "vault": null,
            "closestLiq": {
                "coin": "xyz:XYZ100",
                "progress": 14.88
            }
        },
        {
            "xUserId": null,
            "displayName": null,
            "emoji": null,
            "verified": false,
            "segments": [
                16,
                12
            ],
            "address": "0x583558c85125f81bca152fd85e2010581af7670c",
            "favoriteCount": 0,
            "totalEquity": 5.067614,
            "earliestActivityAt": "2026-03-24T07:07:36.704Z",
            "perpPnl": -0.148187,
            "perpEquity": 4.995213,
            "exposureRatio": 10.27,
            "perpBias": 10.27,
            "openValue": 51.3094,
            "sumUpnl": -0.119,
            "vault": null,
            "closestLiq": {
                "coin": "xyz:GOOGL",
                "progress": 4.45
            }
        },
        {
            "xUserId": null,
            "displayName": null,
            "emoji": null,
            "verified": false,
            "segments": [
                16,
                12
            ],
            "address": "0x9b888c792e1415565e7dc6d75ab8d7960af9ed59",
            "favoriteCount": 0,
            "totalEquity": 19.925465,
            "earliestActivityAt": "2026-03-24T06:54:42.751Z",
            "perpPnl": -0.076011,
            "perpEquity": 19.925465,
            "exposureRatio": 1,
            "perpBias": 1,
            "openValue": 19.918251,
            "sumUpnl": -0.052767,
            "vault": null,
            "closestLiq": {
                "coin": "xyz:COPPER",
                "progress": 10.61
            }
        },
        {
            "xUserId": null,
            "displayName": null,
            "emoji": null,
            "verified": false,
            "segments": [
                16,
                12
            ],
            "address": "0x295ff205a49c1b1221734d4f94a9a5556f0f640f",
            "favoriteCount": 0,
            "totalEquity": 19.981515,
            "earliestActivityAt": "2026-03-24T06:53:29.123Z",
            "perpPnl": -0.018485,
            "perpEquity": 19.977765,
            "exposureRatio": 0.53,
            "perpBias": 0.53,
            "openValue": 10.6299,
            "sumUpnl": -0.03945,
            "vault": null,
            "closestLiq": {
                "coin": "BTC",
                "progress": 0.37
            }
        },
        {
            "xUserId": null,
            "displayName": null,
            "emoji": null,
            "verified": false,
            "segments": [
                16,
                12
            ],
            "address": "0xec7fe4818594821fe297883950c25f577ade4d45",
            "favoriteCount": 0,
            "totalEquity": 48.989272,
            "earliestActivityAt": "2026-03-24T06:53:11.641Z",
            "perpPnl": -1.27894,
            "perpEquity": 23.92281,
            "exposureRatio": 10.46,
            "perpBias": 10.46,
            "openValue": 250.15698,
            "sumUpnl": -1.21785,
            "vault": null,
            "closestLiq": {
                "coin": "BTC",
                "progress": 5.47
            }
        }
    ]
}
```

{% endcode %}

</details>

***

### Get Closed Trades

`/api/external/closed-trades`

{% hint style="success" %}
**Unique to HyperTracker Users**

HyperTracker reconstructs full closed trades from raw Hyperliquid fills. Our real-time fill catcher detects trade closures instantly and builds completed trades within \~10 seconds of the final fill.
{% endhint %}

Returns closed trades for a given wallet address with optional close-time filters. Results use cursor-based pagination.

Each closed trade includes a string `id` and a unique `hash`.

If `startTime` is omitted, the API uses the current time minus 7 days. If `endTime` is omitted, the API uses the current time.

Closed trade history is available back to **July 2025**, but each individual request must use a `startTime` and `endTime` no more than **30 days apart**. For full wallet history, query multiple 30-day windows.

<figure><img src="/files/Uo2NSWYjD4exK0krbFtw" alt=""><figcaption></figcaption></figure>

<details>

<summary>Query Parameters</summary>

<table><thead><tr><th width="116.4296875">Parameter</th><th width="88.953125">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>address</code></td><td><code>string</code></td><td><strong>Required.</strong> Wallet address to fetch closed trades for.</td></tr><tr><td><code>startTime</code></td><td><code>string</code></td><td>Start time using the close time filter. If omitted, current time minus 7 days is used.</td></tr><tr><td><code>endTime</code></td><td><code>string</code></td><td>End time using the close time filter. If omitted, current time is used.</td></tr><tr><td><code>limit</code></td><td><code>number</code></td><td>Limit number of results returned. Default: <code>100</code>.</td></tr><tr><td><code>nextCursor</code></td><td><code>string</code></td><td>Cursor for pagination. Use the cursor returned in the previous response.</td></tr></tbody></table>

</details>

Request Examples

{% tabs %}
{% tab title="Curl" %}

```bash
curl --request GET \
  --url 'https://ht-api.coinmarketman.com/api/external/closed-trades?address=0x1234567890abcdef1234567890abcdef123&startTime=2026-04-24T18:27:01.112Z&endTime=2026-04-25T18:27:01.112Z&limit=100' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'
```

{% endtab %}

{% tab title="JavaScript" %}

```javascript
const url = new URL("https://ht-api.coinmarketman.com/api/external/closed-trades");
url.searchParams.set("address", "0x1234567890abcdef1234567890abcdef123");
url.searchParams.set("startTime", "2026-04-24T18:27:01.112Z");
url.searchParams.set("endTime", "2026-04-25T18:27:01.112Z");
url.searchParams.set("limit", "100");

const response = await fetch(url.toString(), {
  headers: {
    Authorization: "Bearer YOUR_API_TOKEN"
  }
});

const data = await response.json();
```

{% endtab %}

{% tab title="Python" %}

```python
import requests

response = requests.get(
    "https://ht-api.coinmarketman.com/api/external/closed-trades",
    params={
        "address": "0x1234567890abcdef1234567890abcdef123",
        "startTime": "2026-04-24T18:27:01.112Z",
        "endTime": "2026-04-25T18:27:01.112Z",
        "limit": 100,
    },
    headers={
        "Authorization": "Bearer YOUR_API_TOKEN",
    },
)

closed_trades = response.json()
```

{% endtab %}
{% endtabs %}

Response

> 200 Success: Returns closed trades for the requested wallet address, plus `nextCursor` when more results are available.

<details>

<summary>Response Example</summary>

{% code expandable="true" %}

```json
"trades": [
    {
      "address": "0x020ca66c30bec2c4fe3861a94e4db4a498a35872",
      "hash": "AgymbDC-wsT-OGGpTk20pJijWHIAAAAABD6QZwAAAZ3CWZGk",
      "id": "71209063",
      "side": "long",
      "coin": "APE",
      "avgExit": 0.21069315,
      "avgEntry": 0.18391122,
      "duration": 17384919,
      "openTime": "2026-04-24T21:05:58.221Z",
      "closeTime": "2026-04-25T01:55:43.140Z",
      "partial": false,
      "totalSize": 300000,
      "totalUsd": 55173.365152,
      "realizedPnlUsd": 7851.826854,
      "countFills": 79,
      "fee": 35.514352,
      "feeUsd": 35.514352,
      "fundingUsd": 147.238731
    },
    {
      "address": "0x020ca66c30bec2c4fe3861a94e4db4a498a35872",
      "hash": "AgymbDC-wsT-OGGpTk20pJijWHIAAAAABD6QZgAAAZ3BKAEK",
      "id": "71209062",
      "side": "long",
      "coin": "HYPE",
      "avgExit": 41.28423397,
      "avgEntry": 41.19775521,
      "duration": 64270533,
      "openTime": "2026-04-24T02:30:47.109Z",
      "closeTime": "2026-04-24T20:21:57.642Z",
      "partial": false,
      "totalSize": 18888.88,
      "totalUsd": 778179.45434,
      "realizedPnlUsd": 1337.112977,
      "countFills": 513,
      "fee": 445.895464,
      "feeUsd": 445.895464,
      "fundingUsd": -149.521431
    },
    {
      "address": "0x020ca66c30bec2c4fe3861a94e4db4a498a35872",
      "hash": "AgymbDC-wsT-OGGpTk20pJijWHIAAAAABDMzcgAAAZ29OyD_",
      "id": "70464370",
      "side": "long",
      "coin": "HYPE",
      "avgExit": 41.49192731,
      "avgEntry": 41.36552905,
      "duration": 697130,
      "openTime": "2026-04-24T01:52:45.013Z",
      "closeTime": "2026-04-24T02:04:22.143Z",
      "partial": false,
      "totalSize": 9888.88,
      "totalUsd": 409058.75295,
      "realizedPnlUsd": 1009.248507,
      "countFills": 258,
      "fee": 245.810103,
      "feeUsd": 245.810103,
      "fundingUsd": -5.12145
    },
```

{% endcode %}

</details>

***

### Get Closed Trades Summary

`/api/external/closed-trades/summary`

{% hint style="success" %}
**Unique to HyperTracker Users**

HyperTracker reconstructs completed trades from raw Hyperliquid fills, allowing you to analyse full closed trade performance instead of isolated executions.

Closed trades are updated in near real time, usually within \~10 seconds of the final fill.
{% endhint %}

Returns a closed trade performance summary for a given Hyperliquid wallet address.

This endpoint provides a wallet-level summary and per-coin breakdown of the wallet’s closed trade history, including trade count, win rate, long/short behaviour, realised PnL, fees, trade size, volume, duration, profit factor, payoff ratio, and expectancy.

Use this endpoint to quickly profile a wallet’s trading performance, identify which coins it performs best or worst on, and understand the wallet’s overall trading behaviour across a selected interval.

<details>

<summary>Query Parameters</summary>

<table><thead><tr><th width="108.3359375">Parameter</th><th width="91.78515625">Type</th><th width="108.34375">Required</th><th>Description</th></tr></thead><tbody><tr><td><code>address</code></td><td>string</td><td>Yes</td><td>Hyperliquid wallet address to analyse.</td></tr><tr><td><code>interval</code></td><td>string</td><td>No</td><td>Supported values: <code>all</code>, <code>365d</code>, <code>180d</code>, <code>90d</code>, <code>30d</code>, <code>last50</code>. Defaults to <code>all</code>. Date-based intervals include trades closed inside the selected lookback window. <code>last50</code> returns the wallet’s latest 50 closed trades.</td></tr></tbody></table>

</details>

Request Examples

{% tabs %}
{% tab title="Curl" %}

```bash
curl --request GET \
  --url 'https://ht-api.coinmarketman.com/api/external/closed-trades/summary?address=0x1234567890abcdef1234567890abcdef123&interval=90d' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'
```

{% endtab %}

{% tab title="JavaScript" %}

```javascript
const url = new URL("https://ht-api.coinmarketman.com/api/external/closed-trades/summary");

url.searchParams.set("address", "0x1234567890abcdef1234567890abcdef123");
url.searchParams.set("interval", "90d");

const response = await fetch(url.toString(), {
  method: "GET",
  headers: {
    Authorization: "Bearer YOUR_API_TOKEN"
  }
});

const data = await response.json();

console.log(data);
```

{% endtab %}

{% tab title="Python" %}

```python
import requests

response = requests.get(
    "https://ht-api.coinmarketman.com/api/external/closed-trades/summary",
    params={
        "address": "0x1234567890abcdef1234567890abcdef123",
        "interval": "90d",
    },
    headers={
        "Authorization": "Bearer YOUR_API_TOKEN",
    },
)

closed_trades_summary = response.json()

print(closed_trades_summary)
```

{% endtab %}
{% endtabs %}

Response

> 200 Success: Returns aggregate closed trade summary metrics for the requested wallet address and interval.

<details>

<summary>Response Example</summary>

{% code expandable="true" %}

```json
{
  "address": "0x08c14b32c8a48894e4b933090ebcc9ce33b21135",
  "range": "last90Days",
  "updatedAt": "2026-05-18T14:57:14.513Z",
  "summary": {
    "totalTrades": 5,
    "wins": 2,
    "losses": 3,
    "winRate": 0.4,
    "longTrades": 4,
    "shortTrades": 1,
    "avgDuration": 3350607932.8,
    "medianDuration": 356975871,
    "totalWinningPnl": 403761.852268,
    "totalLosingPnl": -81226.363194,
    "netPnl": 322535.48907400004,
    "avgGain": 201880.926134,
    "avgLoss": -27075.454398,
    "medianGain": 201880.92613399998,
    "medianLoss": -20528.9729675,
    "profitFactor": 4.9708227278828225,
    "payoffRatio": 7.456234091824234,
    "expectancy": 64507.097814800014,
    "expectancyPct": 0.09855711028876689,
    "totalFeesPaid": 3041.606564,
    "avgTradeSize": 654514.9063908,
    "medianSizeUsd": 820777.412166,
    "totalVolumeUsd": 6919131.016628566
  },
  "coins": [
    {
      "coin": "CHIP",
      "totalTrades": 2,
      "wins": 0,
      "losses": 2,
      "winRate": 0,
      "longTrades": 1,
      "shortTrades": 1,
      "avgDuration": 68448196,
      "medianDuration": 68448196,
      "totalWinningPnl": 0,
      "totalLosingPnl": -76455.817003,
      "netPnl": -76455.817003,
      "avgGain": null,
      "avgLoss": -38227.9085015,
      "medianGain": null,
      "medianLoss": -38227.9085015,
      "profitFactor": 0,
      "payoffRatio": null,
      "expectancy": null,
      "expectancyPct": null,
      "totalFeesPaid": 863.791462,
      "avgTradeSize": 530387.2365255,
      "medianSizeUsd": 530387.2365255,
      "totalVolumeUsd": 2079537.07409862,
      "volumeSharePct": 0.30054887949092496
    },
    {
      "coin": "HYPE",
      "totalTrades": 1,
      "wins": 1,
      "losses": 0,
      "winRate": 1,
      "longTrades": 1,
      "shortTrades": 0,
      "avgDuration": 12767828087,
      "medianDuration": 12767828087,
      "totalWinningPnl": 399804.399324,
      "totalLosingPnl": 0,
      "netPnl": 399804.399324,
      "avgGain": 399804.399324,
      "avgLoss": null,
      "medianGain": 399804.399324,
      "medianLoss": null,
      "profitFactor": null,
      "payoffRatio": null,
      "expectancy": null,
      "expectancyPct": null,
      "totalFeesPaid": 1150.763003,
      "avgTradeSize": 1068234.92828,
      "medianSizeUsd": 1068234.92828,
      "totalVolumeUsd": 2557254.526871981,
      "volumeSharePct": 0.3695918635918583
    },
    {
      "coin": "BERA",
      "totalTrades": 1,
      "wins": 1,
      "losses": 0,
      "winRate": 1,
      "longTrades": 1,
      "shortTrades": 0,
      "avgDuration": 3491339314,
      "medianDuration": 3491339314,
      "totalWinningPnl": 3957.452944,
      "totalLosingPnl": 0,
      "netPnl": 3957.452944,
      "avgGain": 3957.452944,
      "avgLoss": null,
      "medianGain": 3957.452944,
      "medianLoss": null,
      "profitFactor": null,
      "payoffRatio": null,
      "expectancy": null,
      "expectancyPct": null,
      "totalFeesPaid": 88.281962,
      "avgTradeSize": 98893.964763,
      "medianSizeUsd": 98893.964763,
      "totalVolumeUsd": 196182.757177915,
      "volumeSharePct": 0.028353669948788962
    },
    {
      "coin": "BTC",
      "totalTrades": 1,
      "wins": 0,
      "losses": 1,
      "winRate": 0,
      "longTrades": 1,
      "shortTrades": 0,
      "avgDuration": 356975871,
      "medianDuration": 356975871,
      "totalWinningPnl": 0,
      "totalLosingPnl": -4770.546191,
      "netPnl": -4770.546191,
      "avgGain": null,
      "avgLoss": -4770.546191,
      "medianGain": null,
      "medianLoss": -4770.546191,
      "profitFactor": 0,
      "payoffRatio": null,
      "expectancy": null,
      "expectancyPct": null,
      "totalFeesPaid": 938.770137,
      "avgTradeSize": 1044671.16586,
      "medianSizeUsd": 1044671.16586,
      "totalVolumeUsd": 2086156.65848005,
      "volumeSharePct": 0.3015055869684277
    }
  ]
}
```

{% endcode %}

</details>

<details>

<summary>Response Fields</summary>

<table><thead><tr><th width="122.90234375">Field</th><th width="84.5625">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>address</code></td><td>string</td><td>Wallet address used for the query.</td></tr><tr><td><code>range</code></td><td>string</td><td>Resolved interval used for the summary.</td></tr><tr><td><code>updatedAt</code></td><td>string</td><td>Timestamp of the latest summary update for this wallet.</td></tr><tr><td><code>summary</code></td><td>object</td><td>Wallet-level closed trade summary metrics.</td></tr><tr><td><code>coins</code></td><td>array</td><td>Per-coin closed trade summary metrics.</td></tr></tbody></table>

</details>

<details>

<summary>Summary Object</summary>

<table><thead><tr><th width="169.8359375">Field</th><th width="136.99609375">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>totalTrades</code></td><td>number</td><td>Total number of closed trades in the selected interval.</td></tr><tr><td><code>wins</code></td><td>number</td><td>Number of profitable closed trades.</td></tr><tr><td><code>losses</code></td><td>number</td><td>Number of losing closed trades.</td></tr><tr><td><code>winRate</code></td><td>number</td><td>Win rate as a decimal. Example: <code>0.4</code> = 40%.</td></tr><tr><td><code>longTrades</code></td><td>number</td><td>Number of closed trades opened long.</td></tr><tr><td><code>shortTrades</code></td><td>number</td><td>Number of closed trades opened short.</td></tr><tr><td><code>avgDuration</code></td><td>number</td><td>Average trade duration.</td></tr><tr><td><code>medianDuration</code></td><td>number</td><td>Median trade duration.</td></tr><tr><td><code>totalWinningPnl</code></td><td>number</td><td>Gross realised PnL from winning trades.</td></tr><tr><td><code>totalLosingPnl</code></td><td>number</td><td>Gross realised PnL from losing trades. Returned as a negative value.</td></tr><tr><td><code>netPnl</code></td><td>number</td><td>Net realised PnL across all included closed trades.</td></tr><tr><td><code>avgGain</code></td><td>number/null</td><td>Average PnL of winning trades. Returns <code>null</code> if there are no winning trades.</td></tr><tr><td><code>avgLoss</code></td><td>number/null</td><td>Average PnL of losing trades. Returns <code>null</code> if there are no losing trades.</td></tr><tr><td><code>medianGain</code></td><td>number/null</td><td>Median PnL of winning trades. Returns <code>null</code> if there are no winning trades.</td></tr><tr><td><code>medianLoss</code></td><td>number/null</td><td>Median PnL of losing trades. Returns <code>null</code> if there are no losing trades.</td></tr><tr><td><code>profitFactor</code></td><td>number/null</td><td>Gross winning PnL divided by absolute gross losing PnL: <code>totalWinningPnl / abs(totalLosingPnl)</code>. Example: <code>2.98</code> means the wallet made $2.98 in winning PnL for every $1 lost. Returns <code>null</code> if there are no losing trades.</td></tr><tr><td><code>payoffRatio</code></td><td>number/null</td><td>Average winner divided by absolute average loser: <code>avgGain / abs(avgLoss)</code>. Example: <code>1.36</code> means the average winning trade is 1.36x the size of the average losing trade. Returns <code>null</code> if there are no wins or no losses.</td></tr><tr><td><code>expectancy</code></td><td>number/null</td><td>Average expected PnL per trade: <code>(winRate * avgGain) + ((1 - winRate) * avgLoss)</code>. Returns <code>null</code> if there are no wins or no losses.</td></tr><tr><td><code>expectancyPct</code></td><td>number/null</td><td>Average expected PnL per trade as a percentage of average trade size: <code>expectancy / avgTradeSize</code>. Example: <code>0.0325</code> = 3.25%. Returns <code>null</code> if expectancy or average trade size is unavailable.</td></tr><tr><td><code>totalFeesPaid</code></td><td>number</td><td>Total fees paid across included closed trades.</td></tr><tr><td><code>avgTradeSize</code></td><td>number</td><td>Average trade size in USD.</td></tr><tr><td><code>medianSizeUsd</code></td><td>number</td><td>Median trade size in USD.</td></tr><tr><td><code>totalVolumeUsd</code></td><td>number</td><td>Total traded volume in USD across included closed trades.</td></tr></tbody></table>

</details>

<details>

<summary>Coins Object</summary>

Each object in the `coins` array contains the same core performance metrics, scoped to a specific coin.

<table><thead><tr><th width="161.921875">Field</th><th width="139.953125">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>coin</code></td><td>string</td><td>Coin symbol.</td></tr><tr><td><code>totalTrades</code></td><td>number</td><td>Number of closed trades for this coin.</td></tr><tr><td><code>wins</code></td><td>number</td><td>Number of profitable closed trades for this coin.</td></tr><tr><td><code>losses</code></td><td>number</td><td>Number of losing closed trades for this coin.</td></tr><tr><td><code>winRate</code></td><td>number</td><td>Coin-specific win rate as a decimal. Example: <code>0.4</code> = 40%.</td></tr><tr><td><code>longTrades</code></td><td>number</td><td>Number of long trades for this coin.</td></tr><tr><td><code>shortTrades</code></td><td>number</td><td>Number of short trades for this coin.</td></tr><tr><td><code>avgDuration</code></td><td>number</td><td>Average trade duration for this coin.</td></tr><tr><td><code>medianDuration</code></td><td>number</td><td>Median trade duration for this coin.</td></tr><tr><td><code>totalWinningPnl</code></td><td>number</td><td>Gross realised PnL from winning trades on this coin.</td></tr><tr><td><code>totalLosingPnl</code></td><td>number</td><td>Gross realised PnL from losing trades on this coin. Returned as a negative value.</td></tr><tr><td><code>netPnl</code></td><td>number</td><td>Net realised PnL for this coin.</td></tr><tr><td><code>avgGain</code></td><td>number/null</td><td>Average PnL of winning trades for this coin.</td></tr><tr><td><code>avgLoss</code></td><td>number/null</td><td>Average PnL of losing trades for this coin.</td></tr><tr><td><code>medianGain</code></td><td>number/null</td><td>Median PnL of winning trades for this coin.</td></tr><tr><td><code>medianLoss</code></td><td>number/null</td><td>Median PnL of losing trades for this coin.</td></tr><tr><td><code>profitFactor</code></td><td>number/null</td><td>Gross winning PnL divided by absolute gross losing PnL for this coin. Returns <code>null</code> if there are no losing trades.</td></tr><tr><td><code>payoffRatio</code></td><td>number/null</td><td>Average winner divided by absolute average loser for this coin. Returns <code>null</code> if there are no wins or no losses.</td></tr><tr><td><code>expectancy</code></td><td>number/null</td><td>Average expected PnL per trade for this coin. Returns <code>null</code> if there are no wins or no losses.</td></tr><tr><td><code>expectancyPct</code></td><td>number/null</td><td>Average expected PnL per trade as a percentage of average trade size for this coin.</td></tr><tr><td><code>totalFeesPaid</code></td><td>number</td><td>Total fees paid on this coin.</td></tr><tr><td><code>avgTradeSize</code></td><td>number</td><td>Average trade size in USD for this coin.</td></tr><tr><td><code>medianSizeUsd</code></td><td>number</td><td>Median trade size in USD for this coin.</td></tr><tr><td><code>totalVolumeUsd</code></td><td>number</td><td>Total traded volume in USD for this coin.</td></tr><tr><td><code>volumeSharePct</code></td><td>number</td><td>This coin’s share of the wallet’s total volume in the selected interval. Example: <code>0.3695</code> = 36.95%.</td></tr></tbody></table>

</details>

{% hint style="info" %}
Notes

* `winRate`, `expectancyPct`, and `volumeSharePct` are returned as decimals. Example: `0.4` = 40%.
* `totalLosingPnl`, `avgLoss`, and `medianLoss` are returned as negative values.
* `avgGain`, `avgLoss`, `medianGain`, `medianLoss`, `profitFactor`, `payoffRatio`, `expectancy`, and `expectancyPct` may return `null` when there is not enough data to calculate the metric.
* The `coins` array only includes coins traded by the wallet within the selected interval.
* `last50` is trade-count based, not date based.
  {% endhint %}

***

### Get Closed Trade Fills

`/api/external/closed-trades/{hash}/fills`

<figure><img src="/files/joiMHrODqIt83hDsu86s" alt=""><figcaption></figcaption></figure>

*Returns the fills used to build a specific closed trade. Pass the `hash` from a closed trade record to inspect the underlying executions. Results use cursor-based pagination and can be filtered by fill time.*

<details>

<summary>Path Parameters</summary>

| Parameter | Type     | Description                                                              |
| --------- | -------- | ------------------------------------------------------------------------ |
| `hash`    | `string` | **Required.** Closed trade hash returned by the closed trades endpoints. |

</details>

<details>

<summary>Query Parameters</summary>

| Parameter    | Type     | Description                                                              |
| ------------ | -------- | ------------------------------------------------------------------------ |
| `startTime`  | `string` | Start time using the fill time filter.                                   |
| `endTime`    | `string` | End time using the fill time filter.                                     |
| `limit`      | `number` | Limit number of results returned. Default: `100`.                        |
| `nextCursor` | `string` | Cursor for pagination. Use the cursor returned in the previous response. |

</details>

Request Examples

{% tabs %}
{% tab title="Curl" %}

```bash
curl --request GET \
  --url 'https://ht-api.coinmarketman.com/api/external/closed-trades/AgymbDC-wsT-OGGpTk20pJijWHIAAAAABD6QZwAAAZ3CWZGk/fills?limit=100' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'
```

{% endtab %}

{% tab title="JavaScript" %}

```javascript
const hash = "AgymbDC-wsT-OGGpTk20pJijWHIAAAAABD6QZwAAAZ3CWZGk";
const url = new URL(
  `https://ht-api.coinmarketman.com/api/external/closed-trades/${encodeURIComponent(hash)}/fills`
);

url.searchParams.set("limit", "100");

const response = await fetch(url.toString(), {
  headers: {
    Authorization: "Bearer YOUR_API_TOKEN"
  }
});

const data = await response.json();
```

{% endtab %}

{% tab title="Python" %}

```python
import requests

hash_value = "AgymbDC-wsT-OGGpTk20pJijWHIAAAAABD6QZwAAAZ3CWZGk"

response = requests.get(
    f"https://ht-api.coinmarketman.com/api/external/closed-trades/{hash_value}/fills",
    params={
        "limit": 100,
    },
    headers={
        "Authorization": "Bearer YOUR_API_TOKEN",
    },
)

closed_trade_fills = response.json()
```

{% endtab %}
{% endtabs %}

Response

> 200 Success: Returns the fills for the requested closed trade, plus `nextCursor` when more results are available.

<details>

<summary>Response Example</summary>

{% code expandable="true" %}

```json
{
  "fills": [
    {
      "oid": 397489630486,
      "address": "0x020ca66c30bec2c4fe3861a94e4db4a498a35872",
      "coin": "APE",
      "fullCoinName": "APE",
      "fillType": "perp",
      "px": 0.20782,
      "sz": 1539.6,
      "side": "A",
      "time": "2026-04-25T01:55:43.140Z",
      "startPosition": 1539.6,
      "dir": "Close Long",
      "closedPnl": 36.811836,
      "hash": "0x8f2f96e11ce0452d90a90439eac02c01fa00aec6b7e363ff32f84233dbe41f18",
      "crossed": true,
      "fee": 0.095987,
      "builderFee": 0,
      "tid": 1016229429903918,
      "feeToken": "USDC",
      "builder": "",
      "createdAt": "2026-04-25T01:55:44.310Z",
      "id": "4173359299923279879",
      "blockNumber": 971685932,
      "liquidatedUser": "",
      "liquidationMarkPx": 0,
      "liquidationMethod": ""
    },
    {
      "oid": 397489630486,
      "address": "0x020ca66c30bec2c4fe3861a94e4db4a498a35872",
      "coin": "APE",
      "fullCoinName": "APE",
      "fillType": "perp",
      "px": 0.20787,
      "sz": 53,
      "side": "A",
      "time": "2026-04-25T01:55:43.140Z",
      "startPosition": 1592.6,
      "dir": "Close Long",
      "closedPnl": 1.26988,
      "hash": "0x8f2f96e11ce0452d90a90439eac02c01fa00aec6b7e363ff32f84233dbe41f18",
      "crossed": true,
      "fee": 0.003305,
      "builderFee": 0,
      "tid": 1013975703140241,
      "feeToken": "USDC",
      "builder": "",
      "createdAt": "2026-04-25T01:55:44.310Z",
      "id": "4173359299923279877",
      "blockNumber": 971685932,
      "liquidatedUser": "",
      "liquidationMarkPx": 0,
      "liquidationMethod": ""
    },
    {
      "oid": 397489630486,
      "address": "0x020ca66c30bec2c4fe3861a94e4db4a498a35872",
      "coin": "APE",
      "fullCoinName": "APE",
      "fillType": "perp",
      "px": 0.20791,
      "sz": 45954.4,
      "side": "A",
      "time": "2026-04-25T01:55:43.140Z",
      "startPosition": 47547,
      "dir": "Close Long",
      "closedPnl": 1102.9056,
      "hash": "0x8f2f96e11ce0452d90a90439eac02c01fa00aec6b7e363ff32f84233dbe41f18",
      "crossed": true,
      "fee": 2.866313,
      "builderFee": 0,
      "tid": 1031035244652855,
      "feeToken": "USDC",
      "builder": "",
      "createdAt": "2026-04-25T01:55:44.310Z",
      "id": "4173359299923279875",
      "blockNumber": 971685932,
      "liquidatedUser": "",
      "liquidationMarkPx": 0,
      "liquidationMethod": ""
    }
  ]
}
```

{% endcode %}

</details>

***

### Get User Fills

`/api/external/fills`

{% hint style="success" %}
**Unique to HyperTracker Users**

HyperTracker provides complete fill history for each wallet by indexing all executions since July 2025. This goes beyond the native Hyperliquid API, which is limited to the most recent 10,000 fills per wallet.
{% endhint %}

Returns trade fills (executions) within a selected time window for the requested filters. Each fill represents a single matched execution and includes the wallet address, traded symbol, execution price and size, side (`B` buy or `A` sell), execution timestamp, and position impact (the position before the fill and whether it opened or closed long or short exposure). It also provides execution identifiers (order id and trade id), whether the execution crossed the spread, the transaction hash when available, and all fee attribution including fee amount, fee token, optional builder address, and builder fee.

This endpoint can only be queried **one day at a time**: `end` must be within the same calendar day as `start`. All data fully available from July 2025. TWAPs are listed with the address "0x0000000000000000000000000000000000000000000000000000000000000000".

<details>

<summary>Query Parameters</summary>

| Parameter    | Type     | Description                                                                                          |
| ------------ | -------- | ---------------------------------------------------------------------------------------------------- |
| `limit`      | `number` | Maximum number of metric rows to return in one response.                                             |
| `coin`       | `string` | Filter by one or more coin symbols (for example `ETH`, `BTC`).                                       |
| `nextCursor` | `string` | Cursor for pagination. Use the `nextCursor` value from the previous response to fetch the next page. |
| `address`    | `string` | Filter by one or more wallet addresses.                                                              |
| `builder`    | `string` | Filter by one or more builder addresses.                                                             |
| `start`      | `string` | Start of the time window (ISO8601).                                                                  |
| `end`        | `string` | End of the time window (ISO 8601, UTC). If omitted, the API uses “now”.                              |
| `side`       | `string` | Filter by fill side. Allowed values: `A`, `B`.                                                       |

</details>

Request Examples

{% tabs %}
{% tab title="Curl" %}

```
curl --request GET \
  --url 'https://ht-api.coinmarketman.com/api/external/fills?limit=50&start=2026-02-15T00%3A00%3A00.000Z&end=2026-02-15T23%3A59%3A59.999Z&coin=BTC&coin=ETH' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'
```

{% endtab %}

{% tab title="Python" %}

```
import requests

response = requests.get(
    'https://ht-api.coinmarketman.com/api/external/fills',
    params={
        'limit': 50,
        'start': '2026-02-15T00:00:00.000Z',
        'end': '2026-02-15T23:59:59.999Z',
        'coin': ['BTC', 'ETH']
    },
    headers={'Authorization': 'Bearer YOUR_API_TOKEN'}
)

fills = response.json()
```

{% endtab %}
{% endtabs %}

Response

> 200 Success: Returns a list of fills that match the provided filters.

<details>

<summary>Response Example</summary>

{% code expandable="true" %}

```
{
    "fills": [
        {
            "oid": 227532187118,
            "address": "0x6e010dee6510fe74b27304c2449b8cd76f688ccb",
            "coin": "NEAR",
            "fullCoinName": "NEAR",
            "fillType": "perp",
            "px": 3.0437,
            "sz": 116.8,
            "side": "B",
            "time": "2025-11-08T11:52:15.332Z",
            "startPosition": 705085.9,
            "dir": "Open Long",
            "closedPnl": 0,
            "hash": "0x11ad8c71bc4e4f4e1327042f14e224020488005757416e20b57637c47b422938",
            "crossed": false,
            "fee": 0.01422,
            "builderFee": 0,
            "tid": 774735923292070,
            "feeToken": "USDC",
            "builder": ""
        },
        {
            "oid": 227532842591,
            "address": "0xe9acfdc9322f6f924f007016c082e6891a3c653c",
            "coin": "RENDER",
            "fullCoinName": "RENDER",
            "fillType": "perp",
            "px": 2.4817,
            "sz": 92.7,
            "side": "A",
            "time": "2025-11-08T11:52:15.332Z",
            "startPosition": -375.1,
            "dir": "Open Short",
            "closedPnl": 0,
            "hash": "0x4a1d0ff6566cac8a4b96042f14e22402047a00dbf16fcb5cede5bb4915608674",
            "crossed": false,
            "fee": 0.017484,
            "builderFee": 0,
            "tid": 426077375165070,
            "feeToken": "USDC",
            "builder": ""
        },
        {
            "oid": 227532846147,
            "address": "0x31ca8395cf837de08b24da3f660e77761dfb974b",
            "coin": "RENDER",
            "fullCoinName": "RENDER",
            "fillType": "perp",
            "px": 2.4834,
            "sz": 108.9,
            "side": "A",
            "time": "2025-11-08T11:52:15.332Z",
            "startPosition": 38250.4,
            "dir": "Close Long",
            "closedPnl": 4.545486,
            "hash": "0x4a1d0ff6566cac8a4b96042f14e22402047a00dbf16fcb5cede5bb4915608674",
            "crossed": false,
            "fee": 0,
            "builderFee": 0,
            "tid": 478732670030068,
            "feeToken": "USDC",
            "builder": ""
        },
        {
            "oid": 227532872482,
            "address": "0x6beffb9bec3364ae579fa7cb864effefa7bf2695",
            "coin": "RENDER",
            "fullCoinName": "RENDER",
            "fillType": "perp",
            "px": 2.4817,
            "sz": 92.7,
            "side": "B",
            "time": "2025-11-08T11:52:15.332Z",
            "startPosition": -86904.5,
            "dir": "Close Short",
            "closedPnl": -5.562,
            "hash": "0x4a1d0ff6566cac8a4b96042f14e22402047a00dbf16fcb5cede5bb4915608674",
            "crossed": true,
            "fee": 0.081668,
            "builderFee": 0.023005,
            "tid": 426077375165070,
            "feeToken": "USDC",
            "builder": "0x6530512a6c89c7cfcebc3ba7fcd9ada5f30827a6"
        },
        {
            "oid": 227532799397,
            "address": "0x6ffba85e575759bfd6f726947a8bd422869342c5",
            "coin": "MEGA",
            "fullCoinName": "MEGA",
            "fillType": "perp",
            "px": 0.51922,
            "sz": 481,
            "side": "B",
            "time": "2025-11-08T11:52:19.030Z",
            "startPosition": -422,
            "dir": "Short > Long",
            "closedPnl": 0.66254,
            "hash": "0x9f51d9bf91638000a0cb042f14e24e02095800a52c669ed2431a8512506759eb",
            "crossed": false,
            "fee": 0.13586,
            "builderFee": 0.099897,
            "tid": 730417837040402,
            "feeToken": "USDC",
            "builder": "0xa9ab442f9dfe752dc74b666c41e7a0498baf8687"
        },
        {
            "oid": 227532877190,
            "address": "0x399965e15d4e61ec3529cc98b7f7ebb93b733336",
            "coin": "@142",
            "fullCoinName": "UBTC",
            "fillType": "spot",
            "px": 101996,
            "sz": 0.00483,
            "side": "B",
            "time": "2025-11-08T11:52:15.937Z",
            "startPosition": 2.62687511,
            "dir": "Buy",
            "closedPnl": 0,
            "hash": "0xf3cbe547e5a7ea2bf545042f14e22b02012b002d80ab08fe9794909aa4abc416",
            "crossed": false,
            "fee": -0.00985281,
            "builderFee": 0,
            "tid": 284959311097519,
            "feeToken": "USDC",
            "builder": ""
        },
        {
            "oid": 227532881589,
            "address": "0x577802004817792dffb3890a14d6ca6a082fee74",
            "coin": "@142",
            "fullCoinName": "UBTC",
            "fillType": "spot",
            "px": 101996,
            "sz": 0.00483,
            "side": "A",
            "time": "2025-11-08T11:52:15.937Z",
            "startPosition": 0.00483348,
            "dir": "Sell",
            "closedPnl": -0.34116664,
            "hash": "0xf3cbe547e5a7ea2bf545042f14e22b02012b002d80ab08fe9794909aa4abc416",
            "crossed": true,
            "fee": 0.82369521,
            "builderFee": 0.49264068,
            "tid": 284959311097519,
            "feeToken": "USDC",
            "builder": "0x1924b8561eef20e70ede628a296175d358be80e5"
        }
    ],
    "nextCursor": "BEARER_KEY"
}
```

{% endcode %}

</details>

***

### Get User Funding Fills

`/api/external/fundings`

{% hint style="success" %}
**Unique to HyperTracker**
{% endhint %}

Retrieves a paginated list of funding payments received or paid by a wallet.

Funding is charged or paid hourly while a perp position is open. This endpoint allows you to review a wallet’s full funding history, including the market, position size, funding rate, funding amount, timestamp, and block number for each funding event.

HyperTracker stores funding history from July 2025 onwards, giving access to historical user funding data beyond what is typically available from standard Hyperliquid queries.

<details>

<summary>Query Parameters</summary>

<table><thead><tr><th width="113.57464599609375">Parameter</th><th width="84.3255615234375">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>address</code></td><td><code>string</code></td><td>Wallet address to retrieve funding fills for. Required.</td></tr><tr><td><code>coin</code></td><td><code>string</code></td><td>Optional coin symbol filter. Use this to return funding fills for a specific market only, for example <code>ETH</code>, <code>BTC</code>, <code>HYPE</code>, or <code>xyz:SP500</code>.</td></tr><tr><td><code>startTime</code></td><td><code>string</code></td><td>Optional start time for the requested funding history. If omitted, current time minus 7 days is used. The requested time range cannot exceed 1 month.</td></tr><tr><td><code>endTime</code></td><td><code>string</code></td><td>Optional end time for the requested funding history. If omitted, current time is used. The requested time range cannot exceed 1 month.</td></tr><tr><td><code>limit</code></td><td><code>number</code></td><td>Maximum number of funding records to return.</td></tr><tr><td><code>nextCursor</code></td><td><code>string</code></td><td>Cursor used for pagination. Use the <code>nextCursor</code> value from the previous response to request the next page of results.</td></tr></tbody></table>

</details>

Request Examples

{% tabs %}
{% tab title="Curl" %}

```bash
curl --request GET \
  --url 'https://ht-api.coinmarketman.com/api/external/fundings?address=0x45d26f28196d226497130c4bac709d808fed4029&limit=10' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Accept: application/json'
```

{% endtab %}

{% tab title="JavaScript" %}

```javascript
const response = await fetch(
  'https://ht-api.coinmarketman.com/api/external/fundings?address=0x45d26f28196d226497130c4bac709d808fed4029&limit=10',
  {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer YOUR_API_TOKEN',
      'Accept': 'application/json'
    }
  }
);

const data = await response.json();
console.log(data);
```

{% endtab %}

{% tab title="Python" %}

```python
import requests

url = "https://ht-api.coinmarketman.com/api/external/fundings"

params = {
    "address": "0x45d26f28196d226497130c4bac709d808fed4029",
    "limit": 10
}

headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Accept": "application/json"
}

response = requests.get(url, headers=headers, params=params)
data = response.json()

print(data)
```

{% endtab %}
{% endtabs %}

Response

> **200 Success:** Returns a paginated list of funding fills for the supplied wallet address.

<details>

<summary>Response Fields</summary>

| Field                      | Type     | Description                                                                                                                                       |
| -------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `fundings`                 | `array`  | Array of funding fill records matching the supplied filters.                                                                                      |
| `fundings[].time`          | `string` | Timestamp of the funding event in ISO 8601 format.                                                                                                |
| `fundings[].blockNumber`   | `number` | Hyperliquid block number associated with the funding event.                                                                                       |
| `fundings[].address`       | `string` | Wallet address that paid or received the funding.                                                                                                 |
| `fundings[].coin`          | `string` | Market symbol for the funding event.                                                                                                              |
| `fundings[].fundingAmount` | `number` | Funding amount paid or received by the wallet. Positive values represent funding received. Negative values represent funding paid.                |
| `fundings[].szi`           | `number` | Signed position size at the time of funding. Positive values usually indicate a long position. Negative values usually indicate a short position. |
| `fundings[].fundingRate`   | `number` | Funding rate applied for the funding interval.                                                                                                    |
| `nextCursor`               | `string` | Cursor for pagination. Pass this value as `nextCursor` in the next request to retrieve the next page.                                             |

</details>

<details>

<summary>Response Example</summary>

```json
{
  "fundings": [
    {
      "time": "2026-05-29T14:00:00.045Z",
      "blockNumber": 1015113827,
      "address": "0x45d26f28196d226497130c4bac709d808fed4029",
      "coin": "ZRO",
      "fundingAmount": 0.721909,
      "szi": -57600,
      "fundingRate": 0.0000112708
    },
    {
      "time": "2026-05-29T14:00:00.045Z",
      "blockNumber": 1015113827,
      "address": "0x45d26f28196d226497130c4bac709d808fed4029",
      "coin": "xyz:XYZ100",
      "fundingAmount": -32.342499,
      "szi": 170,
      "fundingRate": 0.00000625
    },
    {
      "time": "2026-05-29T14:00:00.045Z",
      "blockNumber": 1015113827,
      "address": "0x45d26f28196d226497130c4bac709d808fed4029",
      "coin": "xyz:SP500",
      "fundingAmount": 61.279887,
      "szi": 460,
      "fundingRate": -0.000017539
    },
    {
      "time": "2026-05-29T14:00:00.045Z",
      "blockNumber": 1015113827,
      "address": "0x45d26f28196d226497130c4bac709d808fed4029",
      "coin": "xyz:MU",
      "fundingAmount": 31.322839,
      "szi": -1700,
      "fundingRate": 0.0000188889
    },
    {
      "time": "2026-05-29T14:00:00.045Z",
      "blockNumber": 1015113827,
      "address": "0x45d26f28196d226497130c4bac709d808fed4029",
      "coin": "xyz:CL",
      "fundingAmount": 6.971355,
      "szi": -12720,
      "fundingRate": 0.00000625
    },
    {
      "time": "2026-05-29T14:00:00.045Z",
      "blockNumber": 1015113827,
      "address": "0x45d26f28196d226497130c4bac709d808fed4029",
      "coin": "xyz:BRENTOIL",
      "fundingAmount": 75.432298,
      "szi": -25920,
      "fundingRate": 0.0000318821
    },
    {
      "time": "2026-05-29T14:00:00.045Z",
      "blockNumber": 1015113827,
      "address": "0x45d26f28196d226497130c4bac709d808fed4029",
      "coin": "XRP",
      "fundingAmount": 1.972793,
      "szi": -149000,
      "fundingRate": 0.0000101629
    },
    {
      "time": "2026-05-29T14:00:00.045Z",
      "blockNumber": 1015113827,
      "address": "0x45d26f28196d226497130c4bac709d808fed4029",
      "coin": "XPL",
      "fundingAmount": 1.738125,
      "szi": -1500000,
      "fundingRate": 0.0000125
    },
    {
      "time": "2026-05-29T14:00:00.045Z",
      "blockNumber": 1015113827,
      "address": "0x45d26f28196d226497130c4bac709d808fed4029",
      "coin": "VVV",
      "fundingAmount": 0.980372,
      "szi": -15800,
      "fundingRate": 0.0000040723
    },
    {
      "time": "2026-05-29T14:00:00.045Z",
      "blockNumber": 1015113827,
      "address": "0x45d26f28196d226497130c4bac709d808fed4029",
      "coin": "VIRTUAL",
      "fundingAmount": -1.188879,
      "szi": -94500,
      "fundingRate": -0.0000178602
    }
  ],
  "nextCursor": "eyJ0aW1lIjoxNzgwMDYzMjAwMDQ1LCJibG9ja051bWJlciI6MTAxNTExMzgyNywiY29pbiI6IlZJUlRVQUwifQ.NR9JdFT8bt2rV4Lspmqe2t8fBCW_faisn7CJ2XLRbAU"
}
```

</details>

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.coinmarketman.com/endpoints/trader-and-wallet-data.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.