> ## Documentation Index > Fetch the complete documentation index at: https://docs.0xarchive.io/llms.txt > Use this file to discover all available pages before exploring further. # Get HIP-3 wallet funding payments JSON Schema > Get HIP-3 wallet funding payments JSON Schema contract. Includes parameters, response shapes, examples, and implementation notes from the 0xArchive contract. Source OpenAPI: 0xArchive API 1.13.0; 242 paths; 243 component schemas. Funding one wallet paid or received in `[start, end)` on HIP-3 dex markets: one row per position per hourly settlement, ordered by timestamp, then symbol. `funding_amount` is the wallet's cash flow in the market's collateral: positive when received, negative when paid. One request covers at most 31 days; page through longer histories one window at a time. Funding payments start October 13, 2025 13:00 UTC; an empty window before that carries `meta.coverage_from` and `meta.notice`. Billed at 1 credit per 1,000 rows returned, minimum 1 credit per request. ## Route Metadata | Field | Value | | - | - | | Method | `GET` | | Path | `/v1/hyperliquid/hip3/wallets/{address}/funding` | | operationId | `getHip3WalletFunding` | | Tag | HIP-3 Builder Perps - Positions | | Family | HIP-3 | | Deprecated or legacy | no | ## Human endpoint reference Open [`GET /v1/hyperliquid/hip3/wallets/{address}/funding`](https://docs.0xarchive.io/api-reference/hip-3-builder-perps--positions/get-hip-3-wallet-funding-payments) for authentication, parameters, responses, and examples. ## Request Parameters ### Path Parameters ```json theme={"theme":"github-dark"} { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "getHip3WalletFunding path parameters", "type": "object", "required": [ "address" ], "properties": { "address": { "description": "Wallet address: 0x followed by 40 hex characters (case-insensitive).", "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$", "example": "0x5b5d51203a0f9079f8aeb098a6523a13f298c060", "x-parameter-location": "path" } } } ``` ### Query Parameters ```json theme={"theme":"github-dark"} { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "getHip3WalletFunding query parameters", "type": "object", "properties": { "start": { "description": "An instant: Unix milliseconds, or an RFC 3339 string such as `2026-01-01T00:00:00Z` (encode a `+` offset as `%2B`). An unparsable value answers 400 `invalid_time_range`.", "oneOf": [ { "description": "Unix milliseconds.", "type": "integer", "format": "int64", "example": 1767225600000 }, { "description": "RFC 3339 instant.", "type": "string", "format": "date-time", "example": "2026-01-01T00:00:00Z" } ], "x-parameter-location": "query" }, "end": { "description": "An instant: Unix milliseconds, or an RFC 3339 string such as `2026-01-01T00:00:00Z` (encode a `+` offset as `%2B`). An unparsable value answers 400 `invalid_time_range`.", "oneOf": [ { "description": "Unix milliseconds.", "type": "integer", "format": "int64", "example": 1767225600000 }, { "description": "RFC 3339 instant.", "type": "string", "format": "date-time", "example": "2026-01-01T00:00:00Z" } ], "x-parameter-location": "query" }, "symbol": { "description": "Only this market, in `dex:COIN` form (e.g. xyz:TSLA). Must agree with `dex` when both are set.", "type": "string", "x-parameter-location": "query" }, "dex": { "description": "Restrict to one HIP-3 dex (for example `xyz`).", "type": "string", "example": "xyz", "x-parameter-location": "query" }, "limit": { "description": "Maximum rows per page (default 500, max 5000).", "type": "integer", "default": 500, "minimum": 1, "maximum": 5000, "x-parameter-location": "query" }, "cursor": { "description": "Opaque pagination cursor: pass `meta.next_cursor` from the previous page unchanged, with the same filters. Omit it for the first page. Keep every other parameter unchanged.", "type": "string", "x-parameter-location": "query" } } } ``` ### Header Parameters ```json theme={"theme":"github-dark"} { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "getHip3WalletFunding header parameters", "type": "object", "properties": { "0xArchive-Version": { "description": "Selects the 2026-10 response contract. Send `2026-10-01`; any dated version on or after it selects the same shapes. Without the header every response keeps its existing shape. With it:\n\n- The data quality routes, `/v1/status/coverage` and `/v1/symbols` answer the standard `{success, data, meta}` envelope.\n- Record times that are integer milliseconds by default become RFC 3339 UTC strings with millisecond precision, and the integer moves to a `*_ms` field: L4 resting-order `timestamp` (`timestamp_ms`), CVD buckets, HIP-3 oracle reads, Lighter and Lighter on Robinhood Chain liquidations and liquidation volume. Levels and trigger-levels `snapshot_ts` become RFC 3339 with `snapshot_ts_ms`.\n- Error bodies carry the contract `error_code` names: `invalid_parameter` instead of `invalid_query_params` and `invalid_path_params`, `historical_depth_exceeded` instead of `history_window_exceeded`, and `historical_range_exceeded` instead of `request_range_exceeded`; a malformed cursor that fails to parse answers 400 `invalid_cursor` instead of `invalid_query_params`. With `0xArchive-Version: 2026-10-01`, malformed cursors on trades, liquidations, L2 and L4 diffs, order history, TP/SL and order-flow routes answer 400 `invalid_cursor`. Without the header, the first six route families treat a malformed cursor as no cursor and return the first page; order flow answers 400 `invalid_query_params`. Malformed trade time inputs answer 400 `invalid_time_range` with the header and 400 `invalid_query_params` without it.\n\nThe response echoes the selected version in its own `0xArchive-Version` header.", "type": "string", "enum": [ "2026-10-01" ], "example": "2026-10-01", "x-parameter-location": "header" } } } ``` ## Response Contracts ### Status 200 Get HIP-3 wallet funding payments #### application/json ```json theme={"theme":"github-dark"} { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "getHip3WalletFunding response 200", "description": "Funding payments ordered by timestamp, then symbol.", "type": "object", "required": [ "data", "meta", "success" ], "properties": { "data": { "type": "array", "items": { "description": "One hourly funding settlement of one position of a wallet.", "type": "object", "required": [ "coin", "direction", "funding_amount", "funding_rate", "position_size", "symbol", "timestamp" ], "properties": { "block_number": { "description": "Hyperliquid block of the settlement. Omitted when unknown.", "type": "integer", "format": "int64", "example": 1206818191 }, "coin": { "description": "Alias of `symbol`.", "type": "string", "example": "BTC" }, "dex": { "description": "HIP-3 only: dex of the market.", "type": "string", "example": "xyz" }, "direction": { "description": "`received` or `paid`, following the sign of `funding_amount`; `none` when the payment rounds to zero.", "type": "string", "enum": [ "received", "paid", "none" ], "example": "received" }, "funding_amount": { "description": "The wallet's funding cash flow in the market's collateral, 6 decimals: positive when received, negative when paid.", "type": "string", "nullable": true, "example": "2225.541409" }, "funding_rate": { "description": "Hourly funding rate that settled, as a fraction (up to 10 decimals).", "type": "string", "nullable": true, "example": "0.0000125" }, "position_size": { "description": "Signed position size at settlement, in base units. Negative is short.", "type": "string", "nullable": true, "example": "-2319.60124" }, "symbol": { "description": "Market symbol (HIP-3: `dex:COIN`).", "type": "string", "example": "BTC" }, "timestamp": { "description": "Settlement time (UTC).", "type": "string", "format": "date-time", "example": "2026-11-06T00:00:00.025Z" } } } }, "meta": { "description": "Response metadata of the account positions routes. Every instant is RFC 3339 UTC with milliseconds and comes from the data, never the request time.", "type": "object", "required": [ "count", "request_id" ], "properties": { "as_of": { "description": "Instant the returned state describes: the snapshot tick or hour, or the requested as-of time.", "type": "string", "format": "date-time" }, "built_through": { "description": "Every event before this instant is built into the change log and as-of state. Reads are clamped to it.", "type": "string", "format": "date-time" }, "clamped_to": { "description": "Boundary the read was clamped to (`built_through`). Present only when clamped.", "type": "string", "format": "date-time" }, "count": { "description": "Number of records returned.", "type": "integer" }, "coverage_from": { "description": "Coverage start, present with `notice` when the request falls before coverage or the address has no recorded activity.", "type": "string", "format": "date-time" }, "finalized_through": { "description": "Every event before this instant is final and will not be re-derived (Lighter: the trade finalization watermark). Never later than `built_through`.", "type": "string", "format": "date-time" }, "has_more": { "description": "Cursor-paged routes: whether another page follows. `next_cursor` is present exactly when this is `true`. A final page can be empty when the previous page was exactly full; `has_more` is `false` on it.", "type": "boolean" }, "next_cursor": { "description": "Signed, opaque cursor for the next page, bound to the request; present exactly when `has_more` is `true`. Pass it back with the same parameters. A market cursor pins its snapshot; if that snapshot is replaced or expires the next page answers 409 `snapshot_advanced`.", "type": "string", "nullable": true }, "notice": { "description": "Human-readable advisory: before coverage, no recorded activity, or a stale snapshot.", "type": "string" }, "quality": { "description": "Completeness of the snapshot the response was read from: `complete`, `partial`, or `degraded`. Rows carry their own `quality`. On Lighter and Robinhood Chain, snapshots from the latest day, before the venue's daily trade reconcile, can read `degraded` while their rows read `preliminary`; they read `complete` once the reconcile has run.", "type": "string" }, "request_id": { "description": "Unique request ID for support.", "type": "string", "format": "uuid" }, "requested_end": { "description": "The `end` or `timestamp` the caller asked for, echoed when the read was clamped.", "type": "string", "format": "date-time" }, "snapshot_ts": { "description": "Committed snapshot the response was read from. Market routes echo the resolved `hour` here.", "type": "string", "format": "date-time" }, "source": { "description": "How the rows were produced: `snapshot` (live or hourly snapshot), `reconstructed` (as-of state between snapshots), or `changes` (change log), or `funding` (wallet funding payments).", "type": "string", "enum": [ "snapshot", "reconstructed", "changes", "funding" ] }, "stale": { "description": "True on current reads when the latest snapshot is older than 12 minutes; paired with `notice`.", "type": "boolean" }, "symbol": { "description": "Per-symbol routes: the canonical public symbol the response describes (for example `BTC`, `xyz:TSLA`, `HYPE-USDC`, `#0`).", "type": "string", "example": "BTC" }, "totals": { "description": "Market listings, first page only: aggregates over the whole filtered result set, not just this page.", "allOf": [ { "description": "Long and short aggregates of every open position in one market at one snapshot. Averages cover only positions with a known entry (`*_positions_with_entry`). Shares are decimal ratios of the side or total value held by the ten largest positions.", "type": "object", "required": [ "coin", "long_avg_entry_price", "long_count", "long_positions_with_entry", "long_size", "long_top10_value_share", "long_value", "quality", "short_avg_entry_price", "short_count", "short_positions_with_entry", "short_size", "short_top10_value_share", "short_value", "snapshot_ts", "symbol", "top10_value_share" ], "properties": { "coin": { "description": "Alias of `symbol`.", "type": "string", "example": "BTC" }, "dex": { "description": "HIP-3 only.", "type": "string", "example": "xyz" }, "long_avg_entry_price": { "description": "Size-weighted average entry of long positions with a known entry.", "type": "string", "nullable": true, "example": "63120.4" }, "long_count": { "type": "integer", "format": "int64", "example": 18234 }, "long_positions_with_entry": { "type": "integer", "format": "int64", "example": 18230 }, "long_size": { "description": "Total long size in base units.", "type": "string", "example": "8123.45" }, "long_top10_value_share": { "description": "Share of long value held by the ten largest long positions.", "type": "string", "nullable": true, "example": "0.412345" }, "long_value": { "description": "Total long value in USD. Null when any long position has no mark.", "type": "string", "nullable": true, "example": "528000000.5" }, "quality": { "description": "`complete`, `partial`, or `degraded`, from this market's own rows.", "type": "string", "example": "complete" }, "short_avg_entry_price": { "description": "Size-weighted average entry of short positions with a known entry.", "type": "string", "nullable": true, "example": "66210.9" }, "short_count": { "type": "integer", "format": "int64", "example": 15102 }, "short_positions_with_entry": { "type": "integer", "format": "int64", "example": 15100 }, "short_size": { "description": "Total short size in base units.", "type": "string", "example": "8120.1" }, "short_top10_value_share": { "description": "Share of short value held by the ten largest short positions.", "type": "string", "nullable": true, "example": "0.385" }, "short_value": { "description": "Total short value in USD. Null when any short position has no mark.", "type": "string", "nullable": true, "example": "527800000.25" }, "snapshot_ts": { "description": "Snapshot the aggregates describe.", "type": "string", "format": "date-time", "nullable": true }, "symbol": { "type": "string", "example": "BTC" }, "top10_value_share": { "description": "Share of total value held by the ten largest positions.", "type": "string", "nullable": true, "example": "0.301" } } } ] }, "venue": { "description": "Per-symbol routes: the venue the response describes.", "type": "string", "enum": [ "hyperliquid", "hip3", "hip4", "spot", "lighter", "rh-lighter" ], "example": "hyperliquid" } } }, "success": { "type": "boolean", "example": true } } } ``` ##### OpenAPI example ```json theme={"theme":"github-dark"} { "success": true, "data": [ { "timestamp": "2026-11-06T00:00:00.025Z", "symbol": "xyz:GOLD", "coin": "xyz:GOLD", "dex": "xyz", "position_size": "-6438.4594", "funding_rate": "0.00000625", "funding_amount": "164.458373", "direction": "received", "block_number": 1210632898 }, { "timestamp": "2026-11-06T01:00:00.095Z", "symbol": "xyz:GOLD", "coin": "xyz:GOLD", "dex": "xyz", "position_size": "-6438.4594", "funding_rate": "0.00000625", "funding_amount": "164.671647", "direction": "received", "block_number": 1210684428 } ], "meta": { "count": 2, "source": "funding", "has_more": false, "request_id": "3f2a9c71-5b0e-4d68-9a4c-7e1d2b6f8a05" } } ``` ### Status 400 Invalid request: a parameter, symbol, interval, cursor or time range failed validation. See `error_code`. #### application/json ```json theme={"theme":"github-dark"} { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "getHip3WalletFunding response 400", "description": "Body of every non-2xx JSON response. `code` repeats the HTTP status, `error_code` is the stable machine-readable code (see `ErrorCode`), `error` is a human-readable message, and `request_id` identifies the request for support. Validation failures add `param` and, where the accepted set is fixed, `valid_values`. A 404 for a datatype the venue does not offer (`unsupported_for_venue`) adds `venue`, `datatype` and `available_on`; any other unknown path answers 404 `route_not_found`.", "type": "object", "required": [ "code", "error", "error_code", "request_id", "success" ], "properties": { "available_on": { "description": "`unsupported_for_venue` only: the venues and routes that serve the datatype.", "type": "array", "items": { "type": "object", "required": [ "route", "venue" ], "properties": { "route": { "type": "string", "example": "/v1/hyperliquid/orders/{symbol}/flow" }, "venue": { "type": "string", "example": "hyperliquid" } } } }, "code": { "description": "HTTP status code.", "type": "integer", "example": 400 }, "credits_limit": { "description": "`insufficient_credits` only: the period's credit allowance.", "type": "integer", "format": "int64" }, "credits_used": { "description": "`insufficient_credits` only: credits used this period.", "type": "integer", "format": "int64" }, "datatype": { "description": "`unsupported_for_venue` and plan refusals (`forbidden`): the datatype the request asked for, as `GET /v1/capabilities` names it.", "type": "string", "example": "order_flow" }, "error": { "description": "Human-readable message. Wording can change; do not parse it.", "type": "string" }, "error_code": { "description": "Stable, machine-readable error code. Branch on this value, not on the `error` text.\n\n**Contract codes**\n\n| Code | HTTP | Meaning |\n|---|---|---|\n| `invalid_parameter` | 400 | A parameter failed to parse or validate. `param` names it and `valid_values` lists accepted values where the set is fixed. |\n| `invalid_symbol` | 400 | The symbol is not listed on this venue. |\n| `invalid_interval` | 400 | The `interval` (bucket width) is not one this route accepts. |\n| `invalid_cursor` | 400 | The `cursor` is malformed, stale, or was issued for other filters. Restart pagination without a cursor. Trades, liquidations, L2 and L4 diffs, order history and TP/SL routes currently return the first page for a malformed cursor instead. |\n| `invalid_time_range` | 400 | `start` is after `end`, or a time value could not be parsed. |\n| `range_before_coverage` | 400 | The whole requested range ends before the first instant this dataset is served from. |\n| `historical_range_exceeded` | 403 | The requested span is longer than the plan allows in one request or replay. |\n| `historical_depth_exceeded` | 403 | The request reaches further back than the plan's history window. |\n| `unsupported_for_venue` | 404 | The venue does not offer this datatype. The message, `datatype` and `available_on` name where it is served. |\n| `route_not_found` | 404 | No route matches the path or method. `GET /v1/capabilities` lists the routes each venue serves. |\n| `not_found` | 404 | The route exists but the requested resource (for example an incident, endpoint or outcome id) does not. |\n| `unauthorized` | 401 | The API key is missing or invalid. |\n| `forbidden` | 403 | The key is valid but not allowed to make this request, including a dataset its plan does not include: `datatype`, `required_plans` and `upgrade_url` name it. A refused request is not charged. |\n| `insufficient_credits` | 429 | The monthly credit allowance is spent (402 on pay-per-request routes). |\n| `rate_limited` | 429 | Too many requests or concurrent queries. Retry after the interval in the rate-limit headers. |\n| `conflict` | 409 | The request conflicts with the current state of the resource. |\n| `upstream_unavailable` | 503 | A dependency is unavailable or saturated. Retry shortly; the response carries `Retry-After`. |\n| `internal_error` | 500 | An unexpected server error. Quote `request_id` when contacting support. |\n\n**WebSocket only** (sent in `{\"type\":\"error\"}` messages, never by REST)\n\n| Code | Where | Meaning |\n|---|---|---|\n| `endpoint_unsupported` | WebSocket | This WebSocket endpoint does not serve the channel or operation. The message names the endpoint that does. |\n| `slow_consumer` | WebSocket | The connection fell behind a stream and messages were dropped. Re-subscribe, or restart the replay, to resynchronise. |\n\n**Route-specific codes**\n\n| Code | HTTP | Meaning |\n|---|---|---|\n| `positions_unavailable` | 503 | Account positions are temporarily unavailable for this venue. |\n| `reconstruction_unavailable` | 503 | The as-of positions state for this instant cannot be reconstructed right now. |\n| `snapshot_advanced` | 409 | A positions market cursor pinned a snapshot that has since been replaced or expired. Restart pagination. |\n| `pagination_unavailable` | 503 | The next positions page cannot be served right now. Retry the same cursor shortly. |\n| `api_key_limit_reached` | 403 | The account already holds the maximum number of API keys for its plan. |\n| `wallet_requires_plan` | 402 | A wallet-authenticated key needs an active plan for this request. |\n| `wallet_account_required` | 403 | Wallet sign-in needs an existing account linked to the wallet. |\n| `wallet_free_signup_retired` | 410 | Free wallet sign-up is no longer offered. |\n| `account_disabled` | 403 | The account is disabled. |\n| `oauth_not_permitted` | 403 | This route is not available to OAuth access tokens. |\n| `insufficient_scope` | 403 | The OAuth access token lacks the scope this route requires. |\n\n**Legacy names.** Requests without `0xArchive-Version: 2026-10-01` keep the four names that predate the contract; with the header they receive the contract names instead.\n\n| Code | HTTP | Meaning |\n|---|---|---|\n| `invalid_query_params` | 400 | Legacy name of `invalid_parameter` (query parameter), or of `invalid_cursor` when the parameter is `cursor`, sent without the version header. |\n| `invalid_path_params` | 400 | Legacy name of `invalid_parameter` (path parameter), sent without the version header. |\n| `history_window_exceeded` | 403 | Legacy name of `historical_depth_exceeded`, sent without the version header. |\n| `request_range_exceeded` | 403 | Legacy name of `historical_range_exceeded`, sent without the version header. |\n\nTreat any value not listed here as a generic error of the HTTP status.", "type": "string", "enum": [ "invalid_parameter", "invalid_symbol", "invalid_interval", "invalid_cursor", "invalid_time_range", "range_before_coverage", "historical_range_exceeded", "historical_depth_exceeded", "unsupported_for_venue", "route_not_found", "not_found", "unauthorized", "forbidden", "insufficient_credits", "rate_limited", "conflict", "upstream_unavailable", "internal_error", "endpoint_unsupported", "slow_consumer", "positions_unavailable", "reconstruction_unavailable", "snapshot_advanced", "pagination_unavailable", "api_key_limit_reached", "wallet_requires_plan", "wallet_account_required", "wallet_free_signup_retired", "account_disabled", "oauth_not_permitted", "insufficient_scope", "invalid_query_params", "invalid_path_params", "history_window_exceeded", "request_range_exceeded" ], "example": "invalid_parameter" }, "max_concurrent": { "description": "`rate_limited` concurrency refusals only: simultaneous queries the plan allows.", "type": "integer" }, "param": { "description": "The parameter that failed validation, when one did.", "type": "string", "example": "side" }, "request_id": { "description": "Unique request ID for support.", "type": "string", "format": "uuid" }, "required_plans": { "description": "Plan refusals (`forbidden`) only: the plans that include the datatype.", "type": "array", "items": { "type": "string" }, "example": [ "build", "pro", "scale", "enterprise" ] }, "success": { "description": "Always `false` on an error.", "type": "boolean", "enum": [ false ] }, "suggestion": { "description": "Present when the symbol exists on another venue: where to request it instead.", "type": "object", "properties": { "endpoint": { "type": "string", "example": "/v1/hyperliquid/hip3/trades/xyz:TSLA" }, "symbol": { "type": "string", "example": "xyz:TSLA" }, "venue": { "type": "string", "example": "hip3" } } }, "upgrade_url": { "description": "Plan refusals (`forbidden`) only: where to change plan.", "type": "string", "format": "uri", "example": "https://0xarchive.io/pricing" }, "valid_values": { "description": "Accepted values of `param`, when the set is fixed.", "type": "array", "items": { "type": "string" }, "example": [ "buy", "sell" ] }, "venue": { "description": "`unsupported_for_venue` only: the venue the request asked.", "type": "string", "example": "spot" } } } ``` ##### OpenAPI example: `current_main` ```json theme={"theme":"github-dark"} { "code": 400, "error": "Failed to deserialize query string: limit: invalid digit found in string", "error_code": "invalid_query_params", "param": "limit", "request_id": "3f2a9c71-5b0e-4d68-9a4c-7e1d2b6f8a05", "success": false } ``` ##### OpenAPI example: `invalid_parameter` ```json theme={"theme":"github-dark"} { "success": false, "code": 400, "error_code": "invalid_parameter", "error": "Invalid side 'up'. Use buy or sell.", "request_id": "3f2a9c71-5b0e-4d68-9a4c-7e1d2b6f8a05", "param": "side", "valid_values": [ "buy", "sell" ] } ``` ##### OpenAPI example: `invalid_symbol` ```json theme={"theme":"github-dark"} { "success": false, "code": 400, "error_code": "invalid_symbol", "error": "The symbol 'ZZZ' does not exist. Please see /v1/hyperliquid/instruments for available symbols.", "request_id": "3f2a9c71-5b0e-4d68-9a4c-7e1d2b6f8a05", "param": "symbol" } ``` ##### OpenAPI example: `invalid_time_range` ```json theme={"theme":"github-dark"} { "success": false, "code": 400, "error_code": "invalid_time_range", "error": "start must be <= end", "request_id": "3f2a9c71-5b0e-4d68-9a4c-7e1d2b6f8a05" } ``` ##### OpenAPI example: `legacy_invalid_query_params` ```json theme={"theme":"github-dark"} { "success": false, "code": 400, "error_code": "invalid_query_params", "error": "Failed to deserialize query string: limit: invalid digit found in string", "request_id": "3f2a9c71-5b0e-4d68-9a4c-7e1d2b6f8a05" } ``` ### Status 401 Authentication required: the API key is missing or invalid. #### application/json ```json theme={"theme":"github-dark"} { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "getHip3WalletFunding response 401", "description": "Body of every non-2xx JSON response. `code` repeats the HTTP status, `error_code` is the stable machine-readable code (see `ErrorCode`), `error` is a human-readable message, and `request_id` identifies the request for support. Validation failures add `param` and, where the accepted set is fixed, `valid_values`. A 404 for a datatype the venue does not offer (`unsupported_for_venue`) adds `venue`, `datatype` and `available_on`; any other unknown path answers 404 `route_not_found`.", "type": "object", "required": [ "code", "error", "error_code", "request_id", "success" ], "properties": { "available_on": { "description": "`unsupported_for_venue` only: the venues and routes that serve the datatype.", "type": "array", "items": { "type": "object", "required": [ "route", "venue" ], "properties": { "route": { "type": "string", "example": "/v1/hyperliquid/orders/{symbol}/flow" }, "venue": { "type": "string", "example": "hyperliquid" } } } }, "code": { "description": "HTTP status code.", "type": "integer", "example": 400 }, "credits_limit": { "description": "`insufficient_credits` only: the period's credit allowance.", "type": "integer", "format": "int64" }, "credits_used": { "description": "`insufficient_credits` only: credits used this period.", "type": "integer", "format": "int64" }, "datatype": { "description": "`unsupported_for_venue` and plan refusals (`forbidden`): the datatype the request asked for, as `GET /v1/capabilities` names it.", "type": "string", "example": "order_flow" }, "error": { "description": "Human-readable message. Wording can change; do not parse it.", "type": "string" }, "error_code": { "description": "Stable, machine-readable error code. Branch on this value, not on the `error` text.\n\n**Contract codes**\n\n| Code | HTTP | Meaning |\n|---|---|---|\n| `invalid_parameter` | 400 | A parameter failed to parse or validate. `param` names it and `valid_values` lists accepted values where the set is fixed. |\n| `invalid_symbol` | 400 | The symbol is not listed on this venue. |\n| `invalid_interval` | 400 | The `interval` (bucket width) is not one this route accepts. |\n| `invalid_cursor` | 400 | The `cursor` is malformed, stale, or was issued for other filters. Restart pagination without a cursor. Trades, liquidations, L2 and L4 diffs, order history and TP/SL routes currently return the first page for a malformed cursor instead. |\n| `invalid_time_range` | 400 | `start` is after `end`, or a time value could not be parsed. |\n| `range_before_coverage` | 400 | The whole requested range ends before the first instant this dataset is served from. |\n| `historical_range_exceeded` | 403 | The requested span is longer than the plan allows in one request or replay. |\n| `historical_depth_exceeded` | 403 | The request reaches further back than the plan's history window. |\n| `unsupported_for_venue` | 404 | The venue does not offer this datatype. The message, `datatype` and `available_on` name where it is served. |\n| `route_not_found` | 404 | No route matches the path or method. `GET /v1/capabilities` lists the routes each venue serves. |\n| `not_found` | 404 | The route exists but the requested resource (for example an incident, endpoint or outcome id) does not. |\n| `unauthorized` | 401 | The API key is missing or invalid. |\n| `forbidden` | 403 | The key is valid but not allowed to make this request, including a dataset its plan does not include: `datatype`, `required_plans` and `upgrade_url` name it. A refused request is not charged. |\n| `insufficient_credits` | 429 | The monthly credit allowance is spent (402 on pay-per-request routes). |\n| `rate_limited` | 429 | Too many requests or concurrent queries. Retry after the interval in the rate-limit headers. |\n| `conflict` | 409 | The request conflicts with the current state of the resource. |\n| `upstream_unavailable` | 503 | A dependency is unavailable or saturated. Retry shortly; the response carries `Retry-After`. |\n| `internal_error` | 500 | An unexpected server error. Quote `request_id` when contacting support. |\n\n**WebSocket only** (sent in `{\"type\":\"error\"}` messages, never by REST)\n\n| Code | Where | Meaning |\n|---|---|---|\n| `endpoint_unsupported` | WebSocket | This WebSocket endpoint does not serve the channel or operation. The message names the endpoint that does. |\n| `slow_consumer` | WebSocket | The connection fell behind a stream and messages were dropped. Re-subscribe, or restart the replay, to resynchronise. |\n\n**Route-specific codes**\n\n| Code | HTTP | Meaning |\n|---|---|---|\n| `positions_unavailable` | 503 | Account positions are temporarily unavailable for this venue. |\n| `reconstruction_unavailable` | 503 | The as-of positions state for this instant cannot be reconstructed right now. |\n| `snapshot_advanced` | 409 | A positions market cursor pinned a snapshot that has since been replaced or expired. Restart pagination. |\n| `pagination_unavailable` | 503 | The next positions page cannot be served right now. Retry the same cursor shortly. |\n| `api_key_limit_reached` | 403 | The account already holds the maximum number of API keys for its plan. |\n| `wallet_requires_plan` | 402 | A wallet-authenticated key needs an active plan for this request. |\n| `wallet_account_required` | 403 | Wallet sign-in needs an existing account linked to the wallet. |\n| `wallet_free_signup_retired` | 410 | Free wallet sign-up is no longer offered. |\n| `account_disabled` | 403 | The account is disabled. |\n| `oauth_not_permitted` | 403 | This route is not available to OAuth access tokens. |\n| `insufficient_scope` | 403 | The OAuth access token lacks the scope this route requires. |\n\n**Legacy names.** Requests without `0xArchive-Version: 2026-10-01` keep the four names that predate the contract; with the header they receive the contract names instead.\n\n| Code | HTTP | Meaning |\n|---|---|---|\n| `invalid_query_params` | 400 | Legacy name of `invalid_parameter` (query parameter), or of `invalid_cursor` when the parameter is `cursor`, sent without the version header. |\n| `invalid_path_params` | 400 | Legacy name of `invalid_parameter` (path parameter), sent without the version header. |\n| `history_window_exceeded` | 403 | Legacy name of `historical_depth_exceeded`, sent without the version header. |\n| `request_range_exceeded` | 403 | Legacy name of `historical_range_exceeded`, sent without the version header. |\n\nTreat any value not listed here as a generic error of the HTTP status.", "type": "string", "enum": [ "invalid_parameter", "invalid_symbol", "invalid_interval", "invalid_cursor", "invalid_time_range", "range_before_coverage", "historical_range_exceeded", "historical_depth_exceeded", "unsupported_for_venue", "route_not_found", "not_found", "unauthorized", "forbidden", "insufficient_credits", "rate_limited", "conflict", "upstream_unavailable", "internal_error", "endpoint_unsupported", "slow_consumer", "positions_unavailable", "reconstruction_unavailable", "snapshot_advanced", "pagination_unavailable", "api_key_limit_reached", "wallet_requires_plan", "wallet_account_required", "wallet_free_signup_retired", "account_disabled", "oauth_not_permitted", "insufficient_scope", "invalid_query_params", "invalid_path_params", "history_window_exceeded", "request_range_exceeded" ], "example": "invalid_parameter" }, "max_concurrent": { "description": "`rate_limited` concurrency refusals only: simultaneous queries the plan allows.", "type": "integer" }, "param": { "description": "The parameter that failed validation, when one did.", "type": "string", "example": "side" }, "request_id": { "description": "Unique request ID for support.", "type": "string", "format": "uuid" }, "required_plans": { "description": "Plan refusals (`forbidden`) only: the plans that include the datatype.", "type": "array", "items": { "type": "string" }, "example": [ "build", "pro", "scale", "enterprise" ] }, "success": { "description": "Always `false` on an error.", "type": "boolean", "enum": [ false ] }, "suggestion": { "description": "Present when the symbol exists on another venue: where to request it instead.", "type": "object", "properties": { "endpoint": { "type": "string", "example": "/v1/hyperliquid/hip3/trades/xyz:TSLA" }, "symbol": { "type": "string", "example": "xyz:TSLA" }, "venue": { "type": "string", "example": "hip3" } } }, "upgrade_url": { "description": "Plan refusals (`forbidden`) only: where to change plan.", "type": "string", "format": "uri", "example": "https://0xarchive.io/pricing" }, "valid_values": { "description": "Accepted values of `param`, when the set is fixed.", "type": "array", "items": { "type": "string" }, "example": [ "buy", "sell" ] }, "venue": { "description": "`unsupported_for_venue` only: the venue the request asked.", "type": "string", "example": "spot" } } } ``` ##### OpenAPI example ```json theme={"theme":"github-dark"} { "success": false, "code": 401, "error_code": "unauthorized", "error": "Missing authentication credentials. Provide X-API-Key header or Bearer token.", "request_id": "3f2a9c71-5b0e-4d68-9a4c-7e1d2b6f8a05" } ``` ### Status 403 The request is outside the plan's history window or per-request span, or the key is not allowed to make it. #### application/json ```json theme={"theme":"github-dark"} { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "getHip3WalletFunding response 403", "description": "Body of every non-2xx JSON response. `code` repeats the HTTP status, `error_code` is the stable machine-readable code (see `ErrorCode`), `error` is a human-readable message, and `request_id` identifies the request for support. Validation failures add `param` and, where the accepted set is fixed, `valid_values`. A 404 for a datatype the venue does not offer (`unsupported_for_venue`) adds `venue`, `datatype` and `available_on`; any other unknown path answers 404 `route_not_found`.", "type": "object", "required": [ "code", "error", "error_code", "request_id", "success" ], "properties": { "available_on": { "description": "`unsupported_for_venue` only: the venues and routes that serve the datatype.", "type": "array", "items": { "type": "object", "required": [ "route", "venue" ], "properties": { "route": { "type": "string", "example": "/v1/hyperliquid/orders/{symbol}/flow" }, "venue": { "type": "string", "example": "hyperliquid" } } } }, "code": { "description": "HTTP status code.", "type": "integer", "example": 400 }, "credits_limit": { "description": "`insufficient_credits` only: the period's credit allowance.", "type": "integer", "format": "int64" }, "credits_used": { "description": "`insufficient_credits` only: credits used this period.", "type": "integer", "format": "int64" }, "datatype": { "description": "`unsupported_for_venue` and plan refusals (`forbidden`): the datatype the request asked for, as `GET /v1/capabilities` names it.", "type": "string", "example": "order_flow" }, "error": { "description": "Human-readable message. Wording can change; do not parse it.", "type": "string" }, "error_code": { "description": "Stable, machine-readable error code. Branch on this value, not on the `error` text.\n\n**Contract codes**\n\n| Code | HTTP | Meaning |\n|---|---|---|\n| `invalid_parameter` | 400 | A parameter failed to parse or validate. `param` names it and `valid_values` lists accepted values where the set is fixed. |\n| `invalid_symbol` | 400 | The symbol is not listed on this venue. |\n| `invalid_interval` | 400 | The `interval` (bucket width) is not one this route accepts. |\n| `invalid_cursor` | 400 | The `cursor` is malformed, stale, or was issued for other filters. Restart pagination without a cursor. Trades, liquidations, L2 and L4 diffs, order history and TP/SL routes currently return the first page for a malformed cursor instead. |\n| `invalid_time_range` | 400 | `start` is after `end`, or a time value could not be parsed. |\n| `range_before_coverage` | 400 | The whole requested range ends before the first instant this dataset is served from. |\n| `historical_range_exceeded` | 403 | The requested span is longer than the plan allows in one request or replay. |\n| `historical_depth_exceeded` | 403 | The request reaches further back than the plan's history window. |\n| `unsupported_for_venue` | 404 | The venue does not offer this datatype. The message, `datatype` and `available_on` name where it is served. |\n| `route_not_found` | 404 | No route matches the path or method. `GET /v1/capabilities` lists the routes each venue serves. |\n| `not_found` | 404 | The route exists but the requested resource (for example an incident, endpoint or outcome id) does not. |\n| `unauthorized` | 401 | The API key is missing or invalid. |\n| `forbidden` | 403 | The key is valid but not allowed to make this request, including a dataset its plan does not include: `datatype`, `required_plans` and `upgrade_url` name it. A refused request is not charged. |\n| `insufficient_credits` | 429 | The monthly credit allowance is spent (402 on pay-per-request routes). |\n| `rate_limited` | 429 | Too many requests or concurrent queries. Retry after the interval in the rate-limit headers. |\n| `conflict` | 409 | The request conflicts with the current state of the resource. |\n| `upstream_unavailable` | 503 | A dependency is unavailable or saturated. Retry shortly; the response carries `Retry-After`. |\n| `internal_error` | 500 | An unexpected server error. Quote `request_id` when contacting support. |\n\n**WebSocket only** (sent in `{\"type\":\"error\"}` messages, never by REST)\n\n| Code | Where | Meaning |\n|---|---|---|\n| `endpoint_unsupported` | WebSocket | This WebSocket endpoint does not serve the channel or operation. The message names the endpoint that does. |\n| `slow_consumer` | WebSocket | The connection fell behind a stream and messages were dropped. Re-subscribe, or restart the replay, to resynchronise. |\n\n**Route-specific codes**\n\n| Code | HTTP | Meaning |\n|---|---|---|\n| `positions_unavailable` | 503 | Account positions are temporarily unavailable for this venue. |\n| `reconstruction_unavailable` | 503 | The as-of positions state for this instant cannot be reconstructed right now. |\n| `snapshot_advanced` | 409 | A positions market cursor pinned a snapshot that has since been replaced or expired. Restart pagination. |\n| `pagination_unavailable` | 503 | The next positions page cannot be served right now. Retry the same cursor shortly. |\n| `api_key_limit_reached` | 403 | The account already holds the maximum number of API keys for its plan. |\n| `wallet_requires_plan` | 402 | A wallet-authenticated key needs an active plan for this request. |\n| `wallet_account_required` | 403 | Wallet sign-in needs an existing account linked to the wallet. |\n| `wallet_free_signup_retired` | 410 | Free wallet sign-up is no longer offered. |\n| `account_disabled` | 403 | The account is disabled. |\n| `oauth_not_permitted` | 403 | This route is not available to OAuth access tokens. |\n| `insufficient_scope` | 403 | The OAuth access token lacks the scope this route requires. |\n\n**Legacy names.** Requests without `0xArchive-Version: 2026-10-01` keep the four names that predate the contract; with the header they receive the contract names instead.\n\n| Code | HTTP | Meaning |\n|---|---|---|\n| `invalid_query_params` | 400 | Legacy name of `invalid_parameter` (query parameter), or of `invalid_cursor` when the parameter is `cursor`, sent without the version header. |\n| `invalid_path_params` | 400 | Legacy name of `invalid_parameter` (path parameter), sent without the version header. |\n| `history_window_exceeded` | 403 | Legacy name of `historical_depth_exceeded`, sent without the version header. |\n| `request_range_exceeded` | 403 | Legacy name of `historical_range_exceeded`, sent without the version header. |\n\nTreat any value not listed here as a generic error of the HTTP status.", "type": "string", "enum": [ "invalid_parameter", "invalid_symbol", "invalid_interval", "invalid_cursor", "invalid_time_range", "range_before_coverage", "historical_range_exceeded", "historical_depth_exceeded", "unsupported_for_venue", "route_not_found", "not_found", "unauthorized", "forbidden", "insufficient_credits", "rate_limited", "conflict", "upstream_unavailable", "internal_error", "endpoint_unsupported", "slow_consumer", "positions_unavailable", "reconstruction_unavailable", "snapshot_advanced", "pagination_unavailable", "api_key_limit_reached", "wallet_requires_plan", "wallet_account_required", "wallet_free_signup_retired", "account_disabled", "oauth_not_permitted", "insufficient_scope", "invalid_query_params", "invalid_path_params", "history_window_exceeded", "request_range_exceeded" ], "example": "invalid_parameter" }, "max_concurrent": { "description": "`rate_limited` concurrency refusals only: simultaneous queries the plan allows.", "type": "integer" }, "param": { "description": "The parameter that failed validation, when one did.", "type": "string", "example": "side" }, "request_id": { "description": "Unique request ID for support.", "type": "string", "format": "uuid" }, "required_plans": { "description": "Plan refusals (`forbidden`) only: the plans that include the datatype.", "type": "array", "items": { "type": "string" }, "example": [ "build", "pro", "scale", "enterprise" ] }, "success": { "description": "Always `false` on an error.", "type": "boolean", "enum": [ false ] }, "suggestion": { "description": "Present when the symbol exists on another venue: where to request it instead.", "type": "object", "properties": { "endpoint": { "type": "string", "example": "/v1/hyperliquid/hip3/trades/xyz:TSLA" }, "symbol": { "type": "string", "example": "xyz:TSLA" }, "venue": { "type": "string", "example": "hip3" } } }, "upgrade_url": { "description": "Plan refusals (`forbidden`) only: where to change plan.", "type": "string", "format": "uri", "example": "https://0xarchive.io/pricing" }, "valid_values": { "description": "Accepted values of `param`, when the set is fixed.", "type": "array", "items": { "type": "string" }, "example": [ "buy", "sell" ] }, "venue": { "description": "`unsupported_for_venue` only: the venue the request asked.", "type": "string", "example": "spot" } } } ``` ##### OpenAPI example: `historical_depth_exceeded` ```json theme={"theme":"github-dark"} { "success": false, "code": 403, "error_code": "historical_depth_exceeded", "error": "Your plan includes the most recent 30 days of history: this request starts at 2026-01-01T00:00:00Z, before the earliest allowed timestamp 2026-08-30T00:00:00Z. Requests cannot be chunked across the age boundary.", "request_id": "3f2a9c71-5b0e-4d68-9a4c-7e1d2b6f8a05" } ``` ##### OpenAPI example: `historical_range_exceeded` ```json theme={"theme":"github-dark"} { "success": false, "code": 403, "error_code": "historical_range_exceeded", "error": "Maximum range is 30 days per request on your plan. Requested range is 45 days.", "request_id": "3f2a9c71-5b0e-4d68-9a4c-7e1d2b6f8a05" } ``` ### Status 404 Not found. `not_found`: the resource id is unknown. `unsupported_for_venue`: the venue does not offer this datatype (`available_on` names where it is served). `route_not_found`: no route matches the path. #### application/json ```json theme={"theme":"github-dark"} { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "getHip3WalletFunding response 404", "description": "Body of every non-2xx JSON response. `code` repeats the HTTP status, `error_code` is the stable machine-readable code (see `ErrorCode`), `error` is a human-readable message, and `request_id` identifies the request for support. Validation failures add `param` and, where the accepted set is fixed, `valid_values`. A 404 for a datatype the venue does not offer (`unsupported_for_venue`) adds `venue`, `datatype` and `available_on`; any other unknown path answers 404 `route_not_found`.", "type": "object", "required": [ "code", "error", "error_code", "request_id", "success" ], "properties": { "available_on": { "description": "`unsupported_for_venue` only: the venues and routes that serve the datatype.", "type": "array", "items": { "type": "object", "required": [ "route", "venue" ], "properties": { "route": { "type": "string", "example": "/v1/hyperliquid/orders/{symbol}/flow" }, "venue": { "type": "string", "example": "hyperliquid" } } } }, "code": { "description": "HTTP status code.", "type": "integer", "example": 400 }, "credits_limit": { "description": "`insufficient_credits` only: the period's credit allowance.", "type": "integer", "format": "int64" }, "credits_used": { "description": "`insufficient_credits` only: credits used this period.", "type": "integer", "format": "int64" }, "datatype": { "description": "`unsupported_for_venue` and plan refusals (`forbidden`): the datatype the request asked for, as `GET /v1/capabilities` names it.", "type": "string", "example": "order_flow" }, "error": { "description": "Human-readable message. Wording can change; do not parse it.", "type": "string" }, "error_code": { "description": "Stable, machine-readable error code. Branch on this value, not on the `error` text.\n\n**Contract codes**\n\n| Code | HTTP | Meaning |\n|---|---|---|\n| `invalid_parameter` | 400 | A parameter failed to parse or validate. `param` names it and `valid_values` lists accepted values where the set is fixed. |\n| `invalid_symbol` | 400 | The symbol is not listed on this venue. |\n| `invalid_interval` | 400 | The `interval` (bucket width) is not one this route accepts. |\n| `invalid_cursor` | 400 | The `cursor` is malformed, stale, or was issued for other filters. Restart pagination without a cursor. Trades, liquidations, L2 and L4 diffs, order history and TP/SL routes currently return the first page for a malformed cursor instead. |\n| `invalid_time_range` | 400 | `start` is after `end`, or a time value could not be parsed. |\n| `range_before_coverage` | 400 | The whole requested range ends before the first instant this dataset is served from. |\n| `historical_range_exceeded` | 403 | The requested span is longer than the plan allows in one request or replay. |\n| `historical_depth_exceeded` | 403 | The request reaches further back than the plan's history window. |\n| `unsupported_for_venue` | 404 | The venue does not offer this datatype. The message, `datatype` and `available_on` name where it is served. |\n| `route_not_found` | 404 | No route matches the path or method. `GET /v1/capabilities` lists the routes each venue serves. |\n| `not_found` | 404 | The route exists but the requested resource (for example an incident, endpoint or outcome id) does not. |\n| `unauthorized` | 401 | The API key is missing or invalid. |\n| `forbidden` | 403 | The key is valid but not allowed to make this request, including a dataset its plan does not include: `datatype`, `required_plans` and `upgrade_url` name it. A refused request is not charged. |\n| `insufficient_credits` | 429 | The monthly credit allowance is spent (402 on pay-per-request routes). |\n| `rate_limited` | 429 | Too many requests or concurrent queries. Retry after the interval in the rate-limit headers. |\n| `conflict` | 409 | The request conflicts with the current state of the resource. |\n| `upstream_unavailable` | 503 | A dependency is unavailable or saturated. Retry shortly; the response carries `Retry-After`. |\n| `internal_error` | 500 | An unexpected server error. Quote `request_id` when contacting support. |\n\n**WebSocket only** (sent in `{\"type\":\"error\"}` messages, never by REST)\n\n| Code | Where | Meaning |\n|---|---|---|\n| `endpoint_unsupported` | WebSocket | This WebSocket endpoint does not serve the channel or operation. The message names the endpoint that does. |\n| `slow_consumer` | WebSocket | The connection fell behind a stream and messages were dropped. Re-subscribe, or restart the replay, to resynchronise. |\n\n**Route-specific codes**\n\n| Code | HTTP | Meaning |\n|---|---|---|\n| `positions_unavailable` | 503 | Account positions are temporarily unavailable for this venue. |\n| `reconstruction_unavailable` | 503 | The as-of positions state for this instant cannot be reconstructed right now. |\n| `snapshot_advanced` | 409 | A positions market cursor pinned a snapshot that has since been replaced or expired. Restart pagination. |\n| `pagination_unavailable` | 503 | The next positions page cannot be served right now. Retry the same cursor shortly. |\n| `api_key_limit_reached` | 403 | The account already holds the maximum number of API keys for its plan. |\n| `wallet_requires_plan` | 402 | A wallet-authenticated key needs an active plan for this request. |\n| `wallet_account_required` | 403 | Wallet sign-in needs an existing account linked to the wallet. |\n| `wallet_free_signup_retired` | 410 | Free wallet sign-up is no longer offered. |\n| `account_disabled` | 403 | The account is disabled. |\n| `oauth_not_permitted` | 403 | This route is not available to OAuth access tokens. |\n| `insufficient_scope` | 403 | The OAuth access token lacks the scope this route requires. |\n\n**Legacy names.** Requests without `0xArchive-Version: 2026-10-01` keep the four names that predate the contract; with the header they receive the contract names instead.\n\n| Code | HTTP | Meaning |\n|---|---|---|\n| `invalid_query_params` | 400 | Legacy name of `invalid_parameter` (query parameter), or of `invalid_cursor` when the parameter is `cursor`, sent without the version header. |\n| `invalid_path_params` | 400 | Legacy name of `invalid_parameter` (path parameter), sent without the version header. |\n| `history_window_exceeded` | 403 | Legacy name of `historical_depth_exceeded`, sent without the version header. |\n| `request_range_exceeded` | 403 | Legacy name of `historical_range_exceeded`, sent without the version header. |\n\nTreat any value not listed here as a generic error of the HTTP status.", "type": "string", "enum": [ "invalid_parameter", "invalid_symbol", "invalid_interval", "invalid_cursor", "invalid_time_range", "range_before_coverage", "historical_range_exceeded", "historical_depth_exceeded", "unsupported_for_venue", "route_not_found", "not_found", "unauthorized", "forbidden", "insufficient_credits", "rate_limited", "conflict", "upstream_unavailable", "internal_error", "endpoint_unsupported", "slow_consumer", "positions_unavailable", "reconstruction_unavailable", "snapshot_advanced", "pagination_unavailable", "api_key_limit_reached", "wallet_requires_plan", "wallet_account_required", "wallet_free_signup_retired", "account_disabled", "oauth_not_permitted", "insufficient_scope", "invalid_query_params", "invalid_path_params", "history_window_exceeded", "request_range_exceeded" ], "example": "invalid_parameter" }, "max_concurrent": { "description": "`rate_limited` concurrency refusals only: simultaneous queries the plan allows.", "type": "integer" }, "param": { "description": "The parameter that failed validation, when one did.", "type": "string", "example": "side" }, "request_id": { "description": "Unique request ID for support.", "type": "string", "format": "uuid" }, "required_plans": { "description": "Plan refusals (`forbidden`) only: the plans that include the datatype.", "type": "array", "items": { "type": "string" }, "example": [ "build", "pro", "scale", "enterprise" ] }, "success": { "description": "Always `false` on an error.", "type": "boolean", "enum": [ false ] }, "suggestion": { "description": "Present when the symbol exists on another venue: where to request it instead.", "type": "object", "properties": { "endpoint": { "type": "string", "example": "/v1/hyperliquid/hip3/trades/xyz:TSLA" }, "symbol": { "type": "string", "example": "xyz:TSLA" }, "venue": { "type": "string", "example": "hip3" } } }, "upgrade_url": { "description": "Plan refusals (`forbidden`) only: where to change plan.", "type": "string", "format": "uri", "example": "https://0xarchive.io/pricing" }, "valid_values": { "description": "Accepted values of `param`, when the set is fixed.", "type": "array", "items": { "type": "string" }, "example": [ "buy", "sell" ] }, "venue": { "description": "`unsupported_for_venue` only: the venue the request asked.", "type": "string", "example": "spot" } } } ``` ##### OpenAPI example: `current_main` ```json theme={"theme":"github-dark"} { "code": 404, "error": "No L4 checkpoint available before requested timestamp", "error_code": "not_found", "request_id": "ad7df471-eb8a-477c-bd9f-c685a9825f5b", "success": false } ``` ##### OpenAPI example: `not_found` ```json theme={"theme":"github-dark"} { "success": false, "code": 404, "error_code": "not_found", "error": "Resource not found", "request_id": "3f2a9c71-5b0e-4d68-9a4c-7e1d2b6f8a05" } ``` ##### OpenAPI example: `route_not_found` ```json theme={"theme":"github-dark"} { "success": false, "code": 404, "error_code": "route_not_found", "error": "No route matches GET /v1/not-a-route. GET /v1/capabilities lists the routes each venue serves.", "request_id": "3f2a9c71-5b0e-4d68-9a4c-7e1d2b6f8a05" } ``` ##### OpenAPI example: `unsupported_for_venue` ```json theme={"theme":"github-dark"} { "success": false, "code": 404, "error_code": "unsupported_for_venue", "error": "Order flow is not offered on Hyperliquid spot. It is available on Hyperliquid (/v1/hyperliquid/orders/{symbol}/flow), HIP-3 (/v1/hyperliquid/hip3/orders/{symbol}/flow) and HIP-4 (/v1/hyperliquid/hip4/orders/{symbol}/flow).", "request_id": "3f2a9c71-5b0e-4d68-9a4c-7e1d2b6f8a05", "venue": "spot", "datatype": "order_flow", "available_on": [ { "venue": "hyperliquid", "route": "/v1/hyperliquid/orders/{symbol}/flow" }, { "venue": "hip3", "route": "/v1/hyperliquid/hip3/orders/{symbol}/flow" }, { "venue": "hip4", "route": "/v1/hyperliquid/hip4/orders/{symbol}/flow" } ] } ``` ### Status 429 Rate limit, concurrency limit or monthly credits exceeded. See `error_code`. #### application/json ```json theme={"theme":"github-dark"} { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "getHip3WalletFunding response 429", "description": "Body of every non-2xx JSON response. `code` repeats the HTTP status, `error_code` is the stable machine-readable code (see `ErrorCode`), `error` is a human-readable message, and `request_id` identifies the request for support. Validation failures add `param` and, where the accepted set is fixed, `valid_values`. A 404 for a datatype the venue does not offer (`unsupported_for_venue`) adds `venue`, `datatype` and `available_on`; any other unknown path answers 404 `route_not_found`.", "type": "object", "required": [ "code", "error", "error_code", "request_id", "success" ], "properties": { "available_on": { "description": "`unsupported_for_venue` only: the venues and routes that serve the datatype.", "type": "array", "items": { "type": "object", "required": [ "route", "venue" ], "properties": { "route": { "type": "string", "example": "/v1/hyperliquid/orders/{symbol}/flow" }, "venue": { "type": "string", "example": "hyperliquid" } } } }, "code": { "description": "HTTP status code.", "type": "integer", "example": 400 }, "credits_limit": { "description": "`insufficient_credits` only: the period's credit allowance.", "type": "integer", "format": "int64" }, "credits_used": { "description": "`insufficient_credits` only: credits used this period.", "type": "integer", "format": "int64" }, "datatype": { "description": "`unsupported_for_venue` and plan refusals (`forbidden`): the datatype the request asked for, as `GET /v1/capabilities` names it.", "type": "string", "example": "order_flow" }, "error": { "description": "Human-readable message. Wording can change; do not parse it.", "type": "string" }, "error_code": { "description": "Stable, machine-readable error code. Branch on this value, not on the `error` text.\n\n**Contract codes**\n\n| Code | HTTP | Meaning |\n|---|---|---|\n| `invalid_parameter` | 400 | A parameter failed to parse or validate. `param` names it and `valid_values` lists accepted values where the set is fixed. |\n| `invalid_symbol` | 400 | The symbol is not listed on this venue. |\n| `invalid_interval` | 400 | The `interval` (bucket width) is not one this route accepts. |\n| `invalid_cursor` | 400 | The `cursor` is malformed, stale, or was issued for other filters. Restart pagination without a cursor. Trades, liquidations, L2 and L4 diffs, order history and TP/SL routes currently return the first page for a malformed cursor instead. |\n| `invalid_time_range` | 400 | `start` is after `end`, or a time value could not be parsed. |\n| `range_before_coverage` | 400 | The whole requested range ends before the first instant this dataset is served from. |\n| `historical_range_exceeded` | 403 | The requested span is longer than the plan allows in one request or replay. |\n| `historical_depth_exceeded` | 403 | The request reaches further back than the plan's history window. |\n| `unsupported_for_venue` | 404 | The venue does not offer this datatype. The message, `datatype` and `available_on` name where it is served. |\n| `route_not_found` | 404 | No route matches the path or method. `GET /v1/capabilities` lists the routes each venue serves. |\n| `not_found` | 404 | The route exists but the requested resource (for example an incident, endpoint or outcome id) does not. |\n| `unauthorized` | 401 | The API key is missing or invalid. |\n| `forbidden` | 403 | The key is valid but not allowed to make this request, including a dataset its plan does not include: `datatype`, `required_plans` and `upgrade_url` name it. A refused request is not charged. |\n| `insufficient_credits` | 429 | The monthly credit allowance is spent (402 on pay-per-request routes). |\n| `rate_limited` | 429 | Too many requests or concurrent queries. Retry after the interval in the rate-limit headers. |\n| `conflict` | 409 | The request conflicts with the current state of the resource. |\n| `upstream_unavailable` | 503 | A dependency is unavailable or saturated. Retry shortly; the response carries `Retry-After`. |\n| `internal_error` | 500 | An unexpected server error. Quote `request_id` when contacting support. |\n\n**WebSocket only** (sent in `{\"type\":\"error\"}` messages, never by REST)\n\n| Code | Where | Meaning |\n|---|---|---|\n| `endpoint_unsupported` | WebSocket | This WebSocket endpoint does not serve the channel or operation. The message names the endpoint that does. |\n| `slow_consumer` | WebSocket | The connection fell behind a stream and messages were dropped. Re-subscribe, or restart the replay, to resynchronise. |\n\n**Route-specific codes**\n\n| Code | HTTP | Meaning |\n|---|---|---|\n| `positions_unavailable` | 503 | Account positions are temporarily unavailable for this venue. |\n| `reconstruction_unavailable` | 503 | The as-of positions state for this instant cannot be reconstructed right now. |\n| `snapshot_advanced` | 409 | A positions market cursor pinned a snapshot that has since been replaced or expired. Restart pagination. |\n| `pagination_unavailable` | 503 | The next positions page cannot be served right now. Retry the same cursor shortly. |\n| `api_key_limit_reached` | 403 | The account already holds the maximum number of API keys for its plan. |\n| `wallet_requires_plan` | 402 | A wallet-authenticated key needs an active plan for this request. |\n| `wallet_account_required` | 403 | Wallet sign-in needs an existing account linked to the wallet. |\n| `wallet_free_signup_retired` | 410 | Free wallet sign-up is no longer offered. |\n| `account_disabled` | 403 | The account is disabled. |\n| `oauth_not_permitted` | 403 | This route is not available to OAuth access tokens. |\n| `insufficient_scope` | 403 | The OAuth access token lacks the scope this route requires. |\n\n**Legacy names.** Requests without `0xArchive-Version: 2026-10-01` keep the four names that predate the contract; with the header they receive the contract names instead.\n\n| Code | HTTP | Meaning |\n|---|---|---|\n| `invalid_query_params` | 400 | Legacy name of `invalid_parameter` (query parameter), or of `invalid_cursor` when the parameter is `cursor`, sent without the version header. |\n| `invalid_path_params` | 400 | Legacy name of `invalid_parameter` (path parameter), sent without the version header. |\n| `history_window_exceeded` | 403 | Legacy name of `historical_depth_exceeded`, sent without the version header. |\n| `request_range_exceeded` | 403 | Legacy name of `historical_range_exceeded`, sent without the version header. |\n\nTreat any value not listed here as a generic error of the HTTP status.", "type": "string", "enum": [ "invalid_parameter", "invalid_symbol", "invalid_interval", "invalid_cursor", "invalid_time_range", "range_before_coverage", "historical_range_exceeded", "historical_depth_exceeded", "unsupported_for_venue", "route_not_found", "not_found", "unauthorized", "forbidden", "insufficient_credits", "rate_limited", "conflict", "upstream_unavailable", "internal_error", "endpoint_unsupported", "slow_consumer", "positions_unavailable", "reconstruction_unavailable", "snapshot_advanced", "pagination_unavailable", "api_key_limit_reached", "wallet_requires_plan", "wallet_account_required", "wallet_free_signup_retired", "account_disabled", "oauth_not_permitted", "insufficient_scope", "invalid_query_params", "invalid_path_params", "history_window_exceeded", "request_range_exceeded" ], "example": "invalid_parameter" }, "max_concurrent": { "description": "`rate_limited` concurrency refusals only: simultaneous queries the plan allows.", "type": "integer" }, "param": { "description": "The parameter that failed validation, when one did.", "type": "string", "example": "side" }, "request_id": { "description": "Unique request ID for support.", "type": "string", "format": "uuid" }, "required_plans": { "description": "Plan refusals (`forbidden`) only: the plans that include the datatype.", "type": "array", "items": { "type": "string" }, "example": [ "build", "pro", "scale", "enterprise" ] }, "success": { "description": "Always `false` on an error.", "type": "boolean", "enum": [ false ] }, "suggestion": { "description": "Present when the symbol exists on another venue: where to request it instead.", "type": "object", "properties": { "endpoint": { "type": "string", "example": "/v1/hyperliquid/hip3/trades/xyz:TSLA" }, "symbol": { "type": "string", "example": "xyz:TSLA" }, "venue": { "type": "string", "example": "hip3" } } }, "upgrade_url": { "description": "Plan refusals (`forbidden`) only: where to change plan.", "type": "string", "format": "uri", "example": "https://0xarchive.io/pricing" }, "valid_values": { "description": "Accepted values of `param`, when the set is fixed.", "type": "array", "items": { "type": "string" }, "example": [ "buy", "sell" ] }, "venue": { "description": "`unsupported_for_venue` only: the venue the request asked.", "type": "string", "example": "spot" } } } ``` ##### OpenAPI example: `insufficient_credits` ```json theme={"theme":"github-dark"} { "success": false, "code": 429, "error_code": "insufficient_credits", "error": "Monthly credit limit exceeded. Please upgrade your plan.", "request_id": "3f2a9c71-5b0e-4d68-9a4c-7e1d2b6f8a05", "credits_used": 50000, "credits_limit": 50000 } ``` ##### OpenAPI example: `rate_limited` ```json theme={"theme":"github-dark"} { "success": false, "code": 429, "error_code": "rate_limited", "error": "Rate limit exceeded", "request_id": "3f2a9c71-5b0e-4d68-9a4c-7e1d2b6f8a05" } ``` ### Status 503 Funding payments or pagination are temporarily unavailable (`error_code` `positions_unavailable` or `pagination_unavailable`). Retry shortly. #### application/json ```json theme={"theme":"github-dark"} { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "getHip3WalletFunding response 503", "description": "Body of every non-2xx JSON response. `code` repeats the HTTP status, `error_code` is the stable machine-readable code (see `ErrorCode`), `error` is a human-readable message, and `request_id` identifies the request for support. Validation failures add `param` and, where the accepted set is fixed, `valid_values`. A 404 for a datatype the venue does not offer (`unsupported_for_venue`) adds `venue`, `datatype` and `available_on`; any other unknown path answers 404 `route_not_found`.", "type": "object", "required": [ "code", "error", "error_code", "request_id", "success" ], "properties": { "available_on": { "description": "`unsupported_for_venue` only: the venues and routes that serve the datatype.", "type": "array", "items": { "type": "object", "required": [ "route", "venue" ], "properties": { "route": { "type": "string", "example": "/v1/hyperliquid/orders/{symbol}/flow" }, "venue": { "type": "string", "example": "hyperliquid" } } } }, "code": { "description": "HTTP status code.", "type": "integer", "example": 400 }, "credits_limit": { "description": "`insufficient_credits` only: the period's credit allowance.", "type": "integer", "format": "int64" }, "credits_used": { "description": "`insufficient_credits` only: credits used this period.", "type": "integer", "format": "int64" }, "datatype": { "description": "`unsupported_for_venue` and plan refusals (`forbidden`): the datatype the request asked for, as `GET /v1/capabilities` names it.", "type": "string", "example": "order_flow" }, "error": { "description": "Human-readable message. Wording can change; do not parse it.", "type": "string" }, "error_code": { "description": "Stable, machine-readable error code. Branch on this value, not on the `error` text.\n\n**Contract codes**\n\n| Code | HTTP | Meaning |\n|---|---|---|\n| `invalid_parameter` | 400 | A parameter failed to parse or validate. `param` names it and `valid_values` lists accepted values where the set is fixed. |\n| `invalid_symbol` | 400 | The symbol is not listed on this venue. |\n| `invalid_interval` | 400 | The `interval` (bucket width) is not one this route accepts. |\n| `invalid_cursor` | 400 | The `cursor` is malformed, stale, or was issued for other filters. Restart pagination without a cursor. Trades, liquidations, L2 and L4 diffs, order history and TP/SL routes currently return the first page for a malformed cursor instead. |\n| `invalid_time_range` | 400 | `start` is after `end`, or a time value could not be parsed. |\n| `range_before_coverage` | 400 | The whole requested range ends before the first instant this dataset is served from. |\n| `historical_range_exceeded` | 403 | The requested span is longer than the plan allows in one request or replay. |\n| `historical_depth_exceeded` | 403 | The request reaches further back than the plan's history window. |\n| `unsupported_for_venue` | 404 | The venue does not offer this datatype. The message, `datatype` and `available_on` name where it is served. |\n| `route_not_found` | 404 | No route matches the path or method. `GET /v1/capabilities` lists the routes each venue serves. |\n| `not_found` | 404 | The route exists but the requested resource (for example an incident, endpoint or outcome id) does not. |\n| `unauthorized` | 401 | The API key is missing or invalid. |\n| `forbidden` | 403 | The key is valid but not allowed to make this request, including a dataset its plan does not include: `datatype`, `required_plans` and `upgrade_url` name it. A refused request is not charged. |\n| `insufficient_credits` | 429 | The monthly credit allowance is spent (402 on pay-per-request routes). |\n| `rate_limited` | 429 | Too many requests or concurrent queries. Retry after the interval in the rate-limit headers. |\n| `conflict` | 409 | The request conflicts with the current state of the resource. |\n| `upstream_unavailable` | 503 | A dependency is unavailable or saturated. Retry shortly; the response carries `Retry-After`. |\n| `internal_error` | 500 | An unexpected server error. Quote `request_id` when contacting support. |\n\n**WebSocket only** (sent in `{\"type\":\"error\"}` messages, never by REST)\n\n| Code | Where | Meaning |\n|---|---|---|\n| `endpoint_unsupported` | WebSocket | This WebSocket endpoint does not serve the channel or operation. The message names the endpoint that does. |\n| `slow_consumer` | WebSocket | The connection fell behind a stream and messages were dropped. Re-subscribe, or restart the replay, to resynchronise. |\n\n**Route-specific codes**\n\n| Code | HTTP | Meaning |\n|---|---|---|\n| `positions_unavailable` | 503 | Account positions are temporarily unavailable for this venue. |\n| `reconstruction_unavailable` | 503 | The as-of positions state for this instant cannot be reconstructed right now. |\n| `snapshot_advanced` | 409 | A positions market cursor pinned a snapshot that has since been replaced or expired. Restart pagination. |\n| `pagination_unavailable` | 503 | The next positions page cannot be served right now. Retry the same cursor shortly. |\n| `api_key_limit_reached` | 403 | The account already holds the maximum number of API keys for its plan. |\n| `wallet_requires_plan` | 402 | A wallet-authenticated key needs an active plan for this request. |\n| `wallet_account_required` | 403 | Wallet sign-in needs an existing account linked to the wallet. |\n| `wallet_free_signup_retired` | 410 | Free wallet sign-up is no longer offered. |\n| `account_disabled` | 403 | The account is disabled. |\n| `oauth_not_permitted` | 403 | This route is not available to OAuth access tokens. |\n| `insufficient_scope` | 403 | The OAuth access token lacks the scope this route requires. |\n\n**Legacy names.** Requests without `0xArchive-Version: 2026-10-01` keep the four names that predate the contract; with the header they receive the contract names instead.\n\n| Code | HTTP | Meaning |\n|---|---|---|\n| `invalid_query_params` | 400 | Legacy name of `invalid_parameter` (query parameter), or of `invalid_cursor` when the parameter is `cursor`, sent without the version header. |\n| `invalid_path_params` | 400 | Legacy name of `invalid_parameter` (path parameter), sent without the version header. |\n| `history_window_exceeded` | 403 | Legacy name of `historical_depth_exceeded`, sent without the version header. |\n| `request_range_exceeded` | 403 | Legacy name of `historical_range_exceeded`, sent without the version header. |\n\nTreat any value not listed here as a generic error of the HTTP status.", "type": "string", "enum": [ "invalid_parameter", "invalid_symbol", "invalid_interval", "invalid_cursor", "invalid_time_range", "range_before_coverage", "historical_range_exceeded", "historical_depth_exceeded", "unsupported_for_venue", "route_not_found", "not_found", "unauthorized", "forbidden", "insufficient_credits", "rate_limited", "conflict", "upstream_unavailable", "internal_error", "endpoint_unsupported", "slow_consumer", "positions_unavailable", "reconstruction_unavailable", "snapshot_advanced", "pagination_unavailable", "api_key_limit_reached", "wallet_requires_plan", "wallet_account_required", "wallet_free_signup_retired", "account_disabled", "oauth_not_permitted", "insufficient_scope", "invalid_query_params", "invalid_path_params", "history_window_exceeded", "request_range_exceeded" ], "example": "invalid_parameter" }, "max_concurrent": { "description": "`rate_limited` concurrency refusals only: simultaneous queries the plan allows.", "type": "integer" }, "param": { "description": "The parameter that failed validation, when one did.", "type": "string", "example": "side" }, "request_id": { "description": "Unique request ID for support.", "type": "string", "format": "uuid" }, "required_plans": { "description": "Plan refusals (`forbidden`) only: the plans that include the datatype.", "type": "array", "items": { "type": "string" }, "example": [ "build", "pro", "scale", "enterprise" ] }, "success": { "description": "Always `false` on an error.", "type": "boolean", "enum": [ false ] }, "suggestion": { "description": "Present when the symbol exists on another venue: where to request it instead.", "type": "object", "properties": { "endpoint": { "type": "string", "example": "/v1/hyperliquid/hip3/trades/xyz:TSLA" }, "symbol": { "type": "string", "example": "xyz:TSLA" }, "venue": { "type": "string", "example": "hip3" } } }, "upgrade_url": { "description": "Plan refusals (`forbidden`) only: where to change plan.", "type": "string", "format": "uri", "example": "https://0xarchive.io/pricing" }, "valid_values": { "description": "Accepted values of `param`, when the set is fixed.", "type": "array", "items": { "type": "string" }, "example": [ "buy", "sell" ] }, "venue": { "description": "`unsupported_for_venue` only: the venue the request asked.", "type": "string", "example": "spot" } } } ``` ##### OpenAPI example ```json theme={"theme":"github-dark"} { "success": false, "code": 503, "error_code": "positions_unavailable", "error": "Account positions are not available right now.", "request_id": "3f2a9c71-5b0e-4d68-9a4c-7e1d2b6f8a05" } ``` ### Status default Any other error. The body is an `ErrorResponse`; branch on `error_code`. A 503 (`upstream_unavailable`) carries `Retry-After`. #### application/json ```json theme={"theme":"github-dark"} { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "getHip3WalletFunding response default", "description": "Body of every non-2xx JSON response. `code` repeats the HTTP status, `error_code` is the stable machine-readable code (see `ErrorCode`), `error` is a human-readable message, and `request_id` identifies the request for support. Validation failures add `param` and, where the accepted set is fixed, `valid_values`. A 404 for a datatype the venue does not offer (`unsupported_for_venue`) adds `venue`, `datatype` and `available_on`; any other unknown path answers 404 `route_not_found`.", "type": "object", "required": [ "code", "error", "error_code", "request_id", "success" ], "properties": { "available_on": { "description": "`unsupported_for_venue` only: the venues and routes that serve the datatype.", "type": "array", "items": { "type": "object", "required": [ "route", "venue" ], "properties": { "route": { "type": "string", "example": "/v1/hyperliquid/orders/{symbol}/flow" }, "venue": { "type": "string", "example": "hyperliquid" } } } }, "code": { "description": "HTTP status code.", "type": "integer", "example": 400 }, "credits_limit": { "description": "`insufficient_credits` only: the period's credit allowance.", "type": "integer", "format": "int64" }, "credits_used": { "description": "`insufficient_credits` only: credits used this period.", "type": "integer", "format": "int64" }, "datatype": { "description": "`unsupported_for_venue` and plan refusals (`forbidden`): the datatype the request asked for, as `GET /v1/capabilities` names it.", "type": "string", "example": "order_flow" }, "error": { "description": "Human-readable message. Wording can change; do not parse it.", "type": "string" }, "error_code": { "description": "Stable, machine-readable error code. Branch on this value, not on the `error` text.\n\n**Contract codes**\n\n| Code | HTTP | Meaning |\n|---|---|---|\n| `invalid_parameter` | 400 | A parameter failed to parse or validate. `param` names it and `valid_values` lists accepted values where the set is fixed. |\n| `invalid_symbol` | 400 | The symbol is not listed on this venue. |\n| `invalid_interval` | 400 | The `interval` (bucket width) is not one this route accepts. |\n| `invalid_cursor` | 400 | The `cursor` is malformed, stale, or was issued for other filters. Restart pagination without a cursor. Trades, liquidations, L2 and L4 diffs, order history and TP/SL routes currently return the first page for a malformed cursor instead. |\n| `invalid_time_range` | 400 | `start` is after `end`, or a time value could not be parsed. |\n| `range_before_coverage` | 400 | The whole requested range ends before the first instant this dataset is served from. |\n| `historical_range_exceeded` | 403 | The requested span is longer than the plan allows in one request or replay. |\n| `historical_depth_exceeded` | 403 | The request reaches further back than the plan's history window. |\n| `unsupported_for_venue` | 404 | The venue does not offer this datatype. The message, `datatype` and `available_on` name where it is served. |\n| `route_not_found` | 404 | No route matches the path or method. `GET /v1/capabilities` lists the routes each venue serves. |\n| `not_found` | 404 | The route exists but the requested resource (for example an incident, endpoint or outcome id) does not. |\n| `unauthorized` | 401 | The API key is missing or invalid. |\n| `forbidden` | 403 | The key is valid but not allowed to make this request, including a dataset its plan does not include: `datatype`, `required_plans` and `upgrade_url` name it. A refused request is not charged. |\n| `insufficient_credits` | 429 | The monthly credit allowance is spent (402 on pay-per-request routes). |\n| `rate_limited` | 429 | Too many requests or concurrent queries. Retry after the interval in the rate-limit headers. |\n| `conflict` | 409 | The request conflicts with the current state of the resource. |\n| `upstream_unavailable` | 503 | A dependency is unavailable or saturated. Retry shortly; the response carries `Retry-After`. |\n| `internal_error` | 500 | An unexpected server error. Quote `request_id` when contacting support. |\n\n**WebSocket only** (sent in `{\"type\":\"error\"}` messages, never by REST)\n\n| Code | Where | Meaning |\n|---|---|---|\n| `endpoint_unsupported` | WebSocket | This WebSocket endpoint does not serve the channel or operation. The message names the endpoint that does. |\n| `slow_consumer` | WebSocket | The connection fell behind a stream and messages were dropped. Re-subscribe, or restart the replay, to resynchronise. |\n\n**Route-specific codes**\n\n| Code | HTTP | Meaning |\n|---|---|---|\n| `positions_unavailable` | 503 | Account positions are temporarily unavailable for this venue. |\n| `reconstruction_unavailable` | 503 | The as-of positions state for this instant cannot be reconstructed right now. |\n| `snapshot_advanced` | 409 | A positions market cursor pinned a snapshot that has since been replaced or expired. Restart pagination. |\n| `pagination_unavailable` | 503 | The next positions page cannot be served right now. Retry the same cursor shortly. |\n| `api_key_limit_reached` | 403 | The account already holds the maximum number of API keys for its plan. |\n| `wallet_requires_plan` | 402 | A wallet-authenticated key needs an active plan for this request. |\n| `wallet_account_required` | 403 | Wallet sign-in needs an existing account linked to the wallet. |\n| `wallet_free_signup_retired` | 410 | Free wallet sign-up is no longer offered. |\n| `account_disabled` | 403 | The account is disabled. |\n| `oauth_not_permitted` | 403 | This route is not available to OAuth access tokens. |\n| `insufficient_scope` | 403 | The OAuth access token lacks the scope this route requires. |\n\n**Legacy names.** Requests without `0xArchive-Version: 2026-10-01` keep the four names that predate the contract; with the header they receive the contract names instead.\n\n| Code | HTTP | Meaning |\n|---|---|---|\n| `invalid_query_params` | 400 | Legacy name of `invalid_parameter` (query parameter), or of `invalid_cursor` when the parameter is `cursor`, sent without the version header. |\n| `invalid_path_params` | 400 | Legacy name of `invalid_parameter` (path parameter), sent without the version header. |\n| `history_window_exceeded` | 403 | Legacy name of `historical_depth_exceeded`, sent without the version header. |\n| `request_range_exceeded` | 403 | Legacy name of `historical_range_exceeded`, sent without the version header. |\n\nTreat any value not listed here as a generic error of the HTTP status.", "type": "string", "enum": [ "invalid_parameter", "invalid_symbol", "invalid_interval", "invalid_cursor", "invalid_time_range", "range_before_coverage", "historical_range_exceeded", "historical_depth_exceeded", "unsupported_for_venue", "route_not_found", "not_found", "unauthorized", "forbidden", "insufficient_credits", "rate_limited", "conflict", "upstream_unavailable", "internal_error", "endpoint_unsupported", "slow_consumer", "positions_unavailable", "reconstruction_unavailable", "snapshot_advanced", "pagination_unavailable", "api_key_limit_reached", "wallet_requires_plan", "wallet_account_required", "wallet_free_signup_retired", "account_disabled", "oauth_not_permitted", "insufficient_scope", "invalid_query_params", "invalid_path_params", "history_window_exceeded", "request_range_exceeded" ], "example": "invalid_parameter" }, "max_concurrent": { "description": "`rate_limited` concurrency refusals only: simultaneous queries the plan allows.", "type": "integer" }, "param": { "description": "The parameter that failed validation, when one did.", "type": "string", "example": "side" }, "request_id": { "description": "Unique request ID for support.", "type": "string", "format": "uuid" }, "required_plans": { "description": "Plan refusals (`forbidden`) only: the plans that include the datatype.", "type": "array", "items": { "type": "string" }, "example": [ "build", "pro", "scale", "enterprise" ] }, "success": { "description": "Always `false` on an error.", "type": "boolean", "enum": [ false ] }, "suggestion": { "description": "Present when the symbol exists on another venue: where to request it instead.", "type": "object", "properties": { "endpoint": { "type": "string", "example": "/v1/hyperliquid/hip3/trades/xyz:TSLA" }, "symbol": { "type": "string", "example": "xyz:TSLA" }, "venue": { "type": "string", "example": "hip3" } } }, "upgrade_url": { "description": "Plan refusals (`forbidden`) only: where to change plan.", "type": "string", "format": "uri", "example": "https://0xarchive.io/pricing" }, "valid_values": { "description": "Accepted values of `param`, when the set is fixed.", "type": "array", "items": { "type": "string" }, "example": [ "buy", "sell" ] }, "venue": { "description": "`unsupported_for_venue` only: the venue the request asked.", "type": "string", "example": "spot" } } } ``` ##### OpenAPI example: `internal_error` ```json theme={"theme":"github-dark"} { "success": false, "code": 500, "error_code": "internal_error", "error": "Internal server error", "request_id": "3f2a9c71-5b0e-4d68-9a4c-7e1d2b6f8a05" } ``` ##### OpenAPI example: `upstream_unavailable` ```json theme={"theme":"github-dark"} { "success": false, "code": 503, "error_code": "upstream_unavailable", "error": "The service is temporarily unavailable. Retry shortly.", "request_id": "3f2a9c71-5b0e-4d68-9a4c-7e1d2b6f8a05" } ``` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.