> ## 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.

# ApiResponseWalletProfile Schema

> ApiResponseWalletProfile JSON Schema for 0xArchive OpenAPI responses and field contracts. Includes route metadata, schemas, examples, and implementation notes.

Source OpenAPI: 0xArchive API 1.8.0; 227 paths; 217 component schemas.

Use the JSON Schema block below for field-level types, required fields, nested objects, and enum values.

## Required Fields

No required fields are declared on this component schema.

## JSON Schema

```json theme={"theme":"github-dark"}
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "ApiResponseWalletProfile",
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "address": {
          "description": "Wallet address, lowercase.",
          "type": "string"
        },
        "metrics": {
          "description": "Behavioral metrics for one wallet. Ratios run from 0 to 1 unless noted; USD values use fill or order price times size.",
          "type": "object",
          "properties": {
            "active_hours": {
              "description": "Hours with at least one order.",
              "type": "integer"
            },
            "avg_order_size_usd": {
              "description": "Average order notional in USD.",
              "type": "number"
            },
            "buy_volume_usd": {
              "description": "Buy fill volume in USD.",
              "type": "number"
            },
            "cancel_rate": {
              "description": "Share of orders canceled.",
              "type": "number"
            },
            "cloid_ratio": {
              "description": "Share of fills that carried a client order ID.",
              "type": "number"
            },
            "fill_rate": {
              "description": "Share of orders filled.",
              "type": "number"
            },
            "ioc_ratio": {
              "description": "Share of orders that are immediate-or-cancel.",
              "type": "number"
            },
            "liquidation_count": {
              "description": "Fills that were liquidations.",
              "type": "integer"
            },
            "long_short_ratio": {
              "description": "Buy volume divided by sell volume (0 when there is no sell volume). Not bounded by 1.",
              "type": "number"
            },
            "maker_ratio": {
              "description": "Share of fill volume that was maker volume.",
              "type": "number"
            },
            "max_order_size_usd": {
              "description": "Largest order notional in USD.",
              "type": "number"
            },
            "max_single_fill_usd": {
              "description": "Largest single fill in USD.",
              "type": "number"
            },
            "median_cancel_speed_ms": {
              "description": "Median time from placement to cancel, in milliseconds.",
              "type": "number"
            },
            "order_to_trade_ratio": {
              "description": "Orders placed per fill (0 when there are no fills).",
              "type": "number"
            },
            "post_only_ratio": {
              "description": "Share of orders that are post-only.",
              "type": "number"
            },
            "realized_pnl_usd": {
              "description": "Realized PnL from closing fills.",
              "type": "number"
            },
            "sell_volume_usd": {
              "description": "Sell fill volume in USD.",
              "type": "number"
            },
            "top_builder": {
              "description": "Builder address with the most orders. Omitted when no order used a builder.",
              "type": "string"
            },
            "total_builder_fees_paid": {
              "description": "Builder and deployer fees paid.",
              "type": "number"
            },
            "total_fees_usd": {
              "description": "Fees paid, net of rebates.",
              "type": "number"
            },
            "total_fills": {
              "description": "Fills.",
              "type": "integer"
            },
            "total_orders": {
              "description": "Orders placed.",
              "type": "integer"
            },
            "total_priority_gas_paid": {
              "description": "Priority gas paid.",
              "type": "number"
            },
            "total_volume_usd": {
              "description": "Fill volume in USD.",
              "type": "number"
            },
            "tpsl_ratio": {
              "description": "Share of orders that are position TP/SL orders.",
              "type": "number"
            },
            "trigger_order_ratio": {
              "description": "Share of orders that are trigger orders.",
              "type": "number"
            },
            "twap_fill_ratio": {
              "description": "Share of fills that came from a TWAP.",
              "type": "number"
            },
            "unique_coins_traded": {
              "description": "Markets with orders.",
              "type": "integer"
            },
            "unique_fill_coins": {
              "description": "Markets with fills.",
              "type": "integer"
            },
            "uses_builder": {
              "description": "True when any order went through a builder.",
              "type": "boolean"
            },
            "uses_cloid": {
              "description": "True when any fill carried a client order ID.",
              "type": "boolean"
            },
            "uses_priority_gas": {
              "description": "True when any fill paid priority gas.",
              "type": "boolean"
            },
            "uses_tpsl": {
              "description": "True when the wallet placed any position TP/SL order.",
              "type": "boolean"
            },
            "uses_twap": {
              "description": "True when any fill came from a TWAP.",
              "type": "boolean"
            }
          }
        },
        "period": {
          "description": "Lookback window that was applied, for example `24h`.",
          "type": "string",
          "example": "24h"
        }
      }
    },
    "meta": {
      "description": "Response metadata",
      "type": "object",
      "properties": {
        "count": {
          "description": "Number of records returned",
          "type": "integer"
        },
        "coverage_from": {
          "description": "Earliest coverage for the requested symbol and data type. Present only when the requested window ends before coverage begins.",
          "type": "string",
          "format": "date-time"
        },
        "has_more": {
          "description": "Present on cursor-paged routes: true when another page exists. `next_cursor` is present exactly when it is true.",
          "type": "boolean"
        },
        "next_cursor": {
          "description": "Cursor for pagination (timestamp). Use this value as the `cursor` parameter to fetch the next page of results.",
          "type": "string",
          "nullable": true
        },
        "notice": {
          "description": "Human-readable advisory about the response. Used when the requested window ends before coverage begins for the symbol, and on CVD responses that are one page of several; may carry other advisories in future.",
          "type": "string"
        },
        "request_id": {
          "description": "Unique request ID for support",
          "type": "string",
          "format": "uuid"
        },
        "symbol": {
          "description": "Present on per-symbol routes: the symbol the response covers.",
          "type": "string"
        },
        "venue": {
          "description": "Present on per-symbol routes: the venue the response covers, for example `hyperliquid` or `hip3`.",
          "type": "string"
        }
      }
    },
    "success": {
      "type": "boolean",
      "example": true
    }
  }
}
```

## Referenced components

* [ApiMeta](/schemas/components/api-meta)
* [WalletProfile](/schemas/components/wallet-profile)

## Referenced By

* [`GET /v1/hyperliquid/hip3/wallets/{address}/profile`](/schemas/operations/get-hip3-wallet-profile)
* [`GET /v1/hyperliquid/wallets/{address}/profile`](/schemas/operations/get-hyperliquid-wallet-profile)


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