> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hyperdash.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Credit costs

> What every endpoint costs in credits.

Each request costs `multiplier × (base + rows × per_row) + node_read_cost × node_reads` credits. See [Credits](https://docs.hyperdash.com/data-api/credits.md) for how the terms work. The range multiplier applies to the time range you request; a range beyond the endpoint's maximum returns `400 range_too_large`. Candles are priced by the number of bars and allow longer ranges at coarser intervals. Live endpoints with a node read cost usually perform one node read per request.

Every response states its charge in `X-Credits-Charged`, and `GET /v1/quote` returns any request's maximum cost for free.

## Accounts

| Endpoint | Base | Per row | Range multiplier | Node read cost |
| - | - | - | - | - |
| `GET /v1/accounts/batch` | 10 | 15 | | 5 |
| `POST /v1/accounts/batch` | 10 | 15 | | 5 |
| `GET /v1/accounts/batch/portfolio` | 10 | 15 | | 5 |
| `POST /v1/accounts/batch/portfolio` | 10 | 15 | | 5 |
| `GET /v1/accounts/batch/recent-trades` | 470 | 1 | | 0 |
| `GET /v1/accounts/{address}` | 60 | 0 | | 10 |
| `GET /v1/accounts/{address}/account-value` | 10 | 1 | | 0 |
| `GET /v1/accounts/{address}/agents` | 10 | 0 | | 10 |
| `GET /v1/accounts/{address}/builder-fee` | 10 | 0 | | 10 |
| `GET /v1/accounts/{address}/completed-trades` | 300 | 2 | | 0 |
| `GET /v1/accounts/{address}/copy-score` | 20 | 0 | | 0 |
| `GET /v1/accounts/{address}/fees` | 10 | 0 | | 10 |
| `GET /v1/accounts/{address}/fills` | 80 | 2 | ×1 to 1d, ×2 to 7d | 0 |
| `GET /v1/accounts/{address}/funding` | 20 | 1 | ×1 to 1d, ×2 to 7d | 5 |
| `GET /v1/accounts/{address}/highlights` | 40 | 1 | | 0 |
| `GET /v1/accounts/{address}/leaderboard` | 150 | 0 | | 0 |
| `GET /v1/accounts/{address}/ledger` | 20 | 2 | ×1 to 1d, ×2 to 30d | 5 |
| `GET /v1/accounts/{address}/markets-traded` | 80 | 1 | | 0 |
| `GET /v1/accounts/{address}/markets/{coin}` | 10 | 0 | | 10 |
| `GET /v1/accounts/{address}/open-orders` | 15 | 1 | | 5 |
| `GET /v1/accounts/{address}/order-fills` | 190 | 2 | | 0 |
| `GET /v1/accounts/{address}/orders` | 20 | 1 | | 10 |
| `GET /v1/accounts/{address}/outcomes` | 100 | 1 | | 0 |
| `GET /v1/accounts/{address}/pnl-calendar` | 40 | 1 | | 0 |
| `GET /v1/accounts/{address}/pnl-chart` | 15 | 0 | ×1 to 7d, ×3 to 30d, ×4 to 90d, ×10 to 365d, ×11 for all history | 0 |
| `GET /v1/accounts/{address}/pnl-history` | 30 | 0 | | 0 |
| `GET /v1/accounts/{address}/pnl-summary` | 2000 | 0 | | 0 |
| `GET /v1/accounts/{address}/portfolio` | 60 | 0 | | 5 |
| `GET /v1/accounts/{address}/portfolio-daily` | 40 | 1 | | 0 |
| `GET /v1/accounts/{address}/position-history` | 50 | 1 | | 0 |
| `GET /v1/accounts/{address}/positions` | 20 | 1 | | 10 |
| `GET /v1/accounts/{address}/positions/all-dexes` | 60 | 0 | | 10 |
| `GET /v1/accounts/{address}/rate-limit` | 10 | 0 | | 10 |
| `GET /v1/accounts/{address}/review` | 170 | 1 | | 0 |
| `GET /v1/accounts/{address}/risk` | 10 | 0 | | 0 |
| `GET /v1/accounts/{address}/risk-metrics` | 20 | 0 | | 0 |
| `GET /v1/accounts/{address}/sharpe` | 60 | 0 | | 0 |
| `GET /v1/accounts/{address}/spot-balances` | 10 | 1 | | 10 |
| `GET /v1/accounts/{address}/staked-hype` | 20 | 0 | | 0 |
| `GET /v1/accounts/{address}/staking` | 10 | 1 | | 10 |
| `GET /v1/accounts/{address}/stats` | 45 | 0 | | 0 |
| `GET /v1/accounts/{address}/stats/by-market` | 30 | 1 | | 0 |
| `GET /v1/accounts/{address}/subaccounts` | 10 | 15 | | 10 |
| `GET /v1/accounts/{address}/trade-counts` | 30 | 0 | | 0 |
| `GET /v1/accounts/{address}/trades` | 20 | 2 | ×1 to 1d, ×2 to 90d | 5 |
| `GET /v1/accounts/{address}/twap-fills` | 20 | 1 | | 10 |
| `GET /v1/accounts/{address}/twaps` | 20 | 1 | | 5 |
| `GET /v1/accounts/{address}/upnl-rank` | 150 | 0 | | 0 |
| `GET /v1/accounts/{address}/vault-equities` | 10 | 0 | | 10 |
| `GET /v1/accounts/{address}/window-stats` | 20 | 0 | | 0 |
| `GET /v1/accounts/{address}/year-summary` | 20 | 1 | | 0 |

## Async jobs

| Endpoint | Base | Per row | Range multiplier | Node read cost |
| - | - | - | - | - |
| `GET /v1/jobs/{id}/result` | 10 | 1 | | 1 |

The node read cost on `GET /v1/jobs/{id}/result` is the job's compute fee, charged once on the first page: 20 credits per upstream call plus 1 credit per 10 fills scanned. Creating, listing, polling, and cancelling jobs is free.

## Builders

| Endpoint | Base | Per row | Range multiplier | Node read cost |
| - | - | - | - | - |
| `GET /v1/builders/sub-builders` | 20 | 1 | | 0 |
| `GET /v1/builders/{builder}/members` | 20 | 1 | | 0 |
| `GET /v1/builders/{builder}/sub-builders` | 20 | 1 | | 0 |

## Cohorts

| Endpoint | Base | Per row | Range multiplier | Node read cost |
| - | - | - | - | - |
| `GET /v1/cohorts/consensus` | 500 | 1 | | 0 |
| `GET /v1/cohorts/flows` | 900 | 0 | | 0 |
| `GET /v1/cohorts/opens` | 520 | 1 | | 0 |
| `GET /v1/cohorts/positioning` | 20 | 1 | | 0 |
| `GET /v1/cohorts/positioning/markets` | 200 | 0 | | 0 |
| `GET /v1/cohorts/top-positions` | 500 | 1 | | 0 |

## HIP-3 DEXs

| Endpoint | Base | Per row | Range multiplier | Node read cost |
| - | - | - | - | - |
| `GET /v1/dexs` | 5 | 0 | | 5 |

## Leaderboards

| Endpoint | Base | Per row | Range multiplier | Node read cost |
| - | - | - | - | - |
| `GET /v1/leaderboards/pnl` | 400 | 5 | | 5 |
| `GET /v1/leaderboards/portfolio` | 620 | 1 | | 0 |
| `GET /v1/leaderboards/sorted` | 150 | 1 | | 0 |

## Lending

| Endpoint | Base | Per row | Range multiplier | Node read cost |
| - | - | - | - | - |
| `GET /v1/lending/reserves` | 10 | 0 | | 5 |
| `GET /v1/lending/reserves/{token}/history` | 20 | 1 | | 0 |

## Liquidations

| Endpoint | Base | Per row | Range multiplier | Node read cost |
| - | - | - | - | - |
| `GET /v1/liquidations` | 10 | 1 | | 0 |
| `GET /v1/liquidations/by-market` | 20 | 1 | | 0 |
| `GET /v1/liquidations/cascades` | 50 | 1 | ×1 to 30d, ×4 to 90d, ×9 to 365d | 0 |
| `GET /v1/liquidations/minutes` | 20 | 0 | | 0 |
| `GET /v1/liquidations/mix` | 20 | 0 | | 0 |
| `GET /v1/liquidations/series` | 25 | 0 | ×1 to 1d, ×2 to 7d, ×5 to 30d, ×8 to 90d, ×11 to 365d | 0 |
| `GET /v1/liquidations/top` | 170 | 1 | | 0 |

## Markets

| Endpoint | Base | Per row | Range multiplier | Node read cost |
| - | - | - | - | - |
| `GET /v1/markets` | 10 | 0 | | 5 |
| `GET /v1/markets/beta` | 20 | 1 | | 0 |
| `GET /v1/markets/funding/flows` | 360 | 0 | ×1 to 1d, ×6 to 25h | 0 |
| `GET /v1/markets/funding/latest` | 20 | 1 | | 0 |
| `GET /v1/markets/funding/matrix` | 20 | 1 | | 0 |
| `GET /v1/markets/largest-opens` | 300 | 1 | | 0 |
| `GET /v1/markets/margin-tables` | 5 | 0 | | 5 |
| `GET /v1/markets/mids` | 5 | 0 | | 5 |
| `GET /v1/markets/net-positioning` | 20 | 1 | | 0 |
| `GET /v1/markets/net-positioning/summary` | 75 | 0 | | 0 |
| `GET /v1/markets/open-interest/by-category` | 20 | 1 | | 0 |
| `GET /v1/markets/open-interest/by-dex` | 20 | 1 | | 0 |
| `GET /v1/markets/open-interest/changes` | 20 | 1 | | 0 |
| `GET /v1/markets/open-interest/total` | 20 | 1 | | 0 |
| `GET /v1/markets/positioning` | 20 | 1 | | 0 |
| `GET /v1/markets/price-changes` | 20 | 1 | | 5 |
| `GET /v1/markets/returns` | 20 | 1 | | 0 |
| `GET /v1/markets/session-returns` | 20 | 1 | | 0 |
| `GET /v1/markets/stop-summary` | 730 | 1 | | 0 |
| `GET /v1/markets/traded-assets` | 160 | 0 | | 0 |
| `GET /v1/markets/twap-pressure` | 100 | 1 | | 0 |
| `GET /v1/markets/twap-pressure/active` | 10 | 1 | | 5 |
| `GET /v1/markets/window-prices` | 80 | 0 | ×1 to 1d, ×2 to 7d | 0 |
| `GET /v1/markets/{coin}/alo-priority` | 20 | 1 | | 0 |
| `GET /v1/markets/{coin}/alo-priority/bars` | 50 | 1 | ×1 to 1d, ×2 to 7d | 0 |
| `POST /v1/markets/{coin}/alo-priority/lookup` | 20 | 1 | | 0 |
| `GET /v1/markets/{coin}/bar-flows` | 50 | 1 | | 0 |
| `GET /v1/markets/{coin}/book` | 5 | 0 | | 0 |
| `GET /v1/markets/{coin}/book/orders` | 50 | 1 | | 5 |
| `GET /v1/markets/{coin}/box-traders` | 50 | 1 | | 0 |
| `GET /v1/markets/{coin}/candles` | 10 | 1 | ×1 to 1,440 bars, ×2 above | 2 |
| `GET /v1/markets/{coin}/context-history` | 10 | 1 | | 0 |
| `GET /v1/markets/{coin}/cvd` | 20 | 1 | | 0 |
| `GET /v1/markets/{coin}/event-moves` | 20 | 1 | | 0 |
| `GET /v1/markets/{coin}/footprint` | 20 | 1 | | 0 |
| `GET /v1/markets/{coin}/footprint/all-wallets` | 50 | 1 | | 0 |
| `GET /v1/markets/{coin}/funding-rates` | 10 | 1 | | 0 |
| `GET /v1/markets/{coin}/funding/top-wallets` | 330 | 1 | | 0 |
| `GET /v1/markets/{coin}/leaderboard` | 300 | 5 | | 5 |
| `GET /v1/markets/{coin}/liquidation-heatmap` | 20 | 1 | | 0 |
| `GET /v1/markets/{coin}/liquidation-levels` | 20 | 0 | | 0 |
| `GET /v1/markets/{coin}/liquidation-levels/top` | 20 | 1 | | 0 |
| `GET /v1/markets/{coin}/liquidation-levels/totals` | 20 | 0 | | 0 |
| `GET /v1/markets/{coin}/open-interest` | 10 | 1 | | 0 |
| `GET /v1/markets/{coin}/options-iv` | 20 | 1 | | 0 |
| `GET /v1/markets/{coin}/position-book` | 200 | 1 | | 0 |
| `GET /v1/markets/{coin}/position-changes` | 20 | 1 | | 0 |
| `GET /v1/markets/{coin}/position-counts` | 10 | 0 | | 0 |
| `GET /v1/markets/{coin}/positions` | 10 | 1 | | 0 |
| `GET /v1/markets/{coin}/priority-fills` | 40 | 2 | | 0 |
| `GET /v1/markets/{coin}/sentiment` | 25 | 1 | | 0 |
| `GET /v1/markets/{coin}/session-gaps` | 20 | 1 | | 0 |
| `GET /v1/markets/{coin}/session-slots` | 20 | 1 | | 0 |
| `GET /v1/markets/{coin}/stop-heatmap` | 20 | 1 | | 0 |
| `GET /v1/markets/{coin}/stop-levels` | 20 | 0 | | 0 |
| `GET /v1/markets/{coin}/stop-levels/top` | 20 | 1 | | 0 |
| `GET /v1/markets/{coin}/stop-levels/totals` | 10 | 0 | | 0 |
| `GET /v1/markets/{coin}/stop-orders` | 20 | 1 | | 0 |
| `GET /v1/markets/{coin}/trade-bars` | 10 | 1 | | 0 |
| `GET /v1/markets/{coin}/trades` | 40 | 1 | | 0 |
| `GET /v1/markets/{coin}/twap-levels` | 10 | 1 | | 5 |
| `GET /v1/markets/{coin}/twaps` | 10 | 1 | | 5 |
| `GET /v1/markets/{coin}/volatility` | 20 | 0 | ×1 to 1d, ×2 to 7d, ×5 to 30d, ×8 to 90d, ×11 to 365d | 0 |

A 1-day range on `GET /v1/markets/funding/flows` that is not aligned to whole hours is snapped outward to 25 hours and costs ×6.

## Network

| Endpoint | Base | Per row | Range multiplier | Node read cost |
| - | - | - | - | - |
| `GET /v1/network/active-traders` | 400 | 0 | ×1 to 1d, ×3 to 7d | 0 |
| `GET /v1/network/af-buybacks` | 10 | 1 | | 0 |
| `GET /v1/network/bridge-flows` | 20 | 0 | ×1 to 1d, ×2 to 7d, ×5 to 30d, ×8 to 90d, ×11 to 365d | 0 |
| `GET /v1/network/builder-volume-share` | 20 | 1 | | 0 |
| `GET /v1/network/deploy-auctions` | 5 | 0 | | 5 |
| `GET /v1/network/etf-flows/{asset}` | 20 | 0 | | 0 |
| `GET /v1/network/fees` | 280 | 0 | ×1 to 1d, ×3 to 7d | 0 |
| `GET /v1/network/hlp` | 10 | 1 | | 0 |
| `GET /v1/network/hype-holders` | 10 | 1 | | 0 |
| `GET /v1/network/hype-supply` | 10 | 1 | | 0 |
| `GET /v1/network/new-traders` | 430 | 1 | | 0 |
| `GET /v1/network/priority-fees` | 25 | 0 | ×1 to 1d, ×3 to 7d, ×6 to 30d, ×12 to 90d, ×16 to 365d | 0 |
| `GET /v1/network/priority-fees/builder-share` | 50 | 0 | ×1 to 1d, ×2 to 7d, ×5 to 30d, ×8 to 90d | 0 |
| `GET /v1/network/priority-fees/by-coin` | 50 | 0 | ×1 to 1d, ×2 to 7d, ×5 to 30d, ×8 to 90d | 0 |
| `GET /v1/network/priority-fees/summary` | 50 | 0 | ×1 to 1d, ×2 to 7d, ×5 to 30d, ×8 to 90d, ×11 to 365d | 0 |
| `GET /v1/network/priority-fees/top-coins` | 50 | 1 | | 0 |
| `GET /v1/network/priority-fees/top-users` | 220 | 1 | | 0 |
| `GET /v1/network/revenue` | 20 | 1 | | 0 |
| `GET /v1/network/trader-classes/{trader_class}` | 60 | 0 | | 0 |
| `GET /v1/network/trader-distribution` | 800 | 0 | | 0 |
| `GET /v1/network/trader-profitability` | 10 | 1 | | 0 |
| `GET /v1/network/trader-profitability/window` | 550 | 0 | ×2 to 7d, ×3 to 30d | 0 |
| `GET /v1/network/usdc-reserve` | 20 | 1 | | 0 |
| `GET /v1/network/user-growth` | 145 | 1 | | 0 |
| `GET /v1/network/venue-share` | 20 | 1 | | 0 |
| `GET /v1/network/whale-deposits` | 20 | 1 | | 0 |

## Outcomes

| Endpoint | Base | Per row | Range multiplier | Node read cost |
| - | - | - | - | - |
| `GET /v1/outcomes` | 20 | 1 | | 0 |
| `GET /v1/outcomes/activity` | 250 | 1 | | 0 |
| `GET /v1/outcomes/leaderboard` | 730 | 1 | | 0 |
| `GET /v1/outcomes/markets` | 25 | 1 | | 0 |
| `GET /v1/outcomes/whale-trades` | 760 | 1 | | 0 |
| `GET /v1/outcomes/{outcome}/holders` | 720 | 1 | | 5 |
| `GET /v1/outcomes/{outcome}/probability` | 35 | 1 | | 0 |

## Positions

| Endpoint | Base | Per row | Range multiplier | Node read cost |
| - | - | - | - | - |
| `GET /v1/positions/fresh-wallets` | 200 | 1 | | 0 |
| `GET /v1/positions/largest` | 100 | 1 | | 0 |
| `GET /v1/positions/near-liquidation` | 100 | 1 | | 5 |

## Snapshots

| Endpoint | Base | Per row | Range multiplier | Node read cost |
| - | - | - | - | - |
| `GET /v1/snapshots/account-values` | 20 | 1 | | 0 |
| `GET /v1/snapshots/borrowers` | 20 | 1 | | 0 |
| `GET /v1/snapshots/portfolio-margin-accounts` | 20 | 1 | | 0 |
| `GET /v1/snapshots/positioned-accounts` | 20 | 1 | | 0 |
| `GET /v1/snapshots/positions/{coin}` | 20 | 1 | | 0 |
| `GET /v1/snapshots/spot-holders/{token}` | 20 | 1 | | 0 |
| `GET /v1/snapshots/trigger-orders/{coin}` | 20 | 1 | | 0 |

## Spot

| Endpoint | Base | Per row | Range multiplier | Node read cost |
| - | - | - | - | - |
| `GET /v1/spot/markets` | 10 | 0 | | 5 |
| `GET /v1/spot/tokens/{token}/holder-bands` | 1500 | 0 | | 0 |
| `GET /v1/spot/{token}/twap-levels` | 10 | 1 | | 5 |
| `GET /v1/spot/{token}/twaps` | 10 | 1 | | 5 |

## Staking

| Endpoint | Base | Per row | Range multiplier | Node read cost |
| - | - | - | - | - |
| `GET /v1/staking/flows` | 10 | 1 | | 0 |
| `GET /v1/staking/history` | 10 | 1 | | 0 |
| `GET /v1/staking/top-stakers` | 20 | 1 | | 0 |
| `GET /v1/staking/validators` | 20 | 1 | | 0 |

## Traders

| Endpoint | Base | Per row | Range multiplier | Node read cost |
| - | - | - | - | - |
| `GET /v1/traders/cohort` | 1160 | 1 | | 0 |
| `GET /v1/traders/groups/{group}` | 20 | 1 | | 0 |
| `GET /v1/traders/screener` | 870 | 1 | | 0 |
| `GET /v1/traders/top-unrealized` | 100 | 1 | | 0 |
| `GET /v1/traders/unrealized-movers` | 150 | 1 | | 0 |

## Streams

Every channel costs 1 credit per acknowledged event, with no base cost: `bbo`, `book`, `candles`, `ctx`, `fills`, `ledger`, `liquidation-levels`, `liquidations`, `orders`, `stop-levels`, `trades`, `twap`. Replays you already paid for are free.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.