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

# activeAssetData | Hyperliquid Info API

> Hyperliquid activeAssetData: fetch a user's active trading limits, leverage setting, available size, and mark price for a single Hyperliquid perpetual asset.

<CardGroup cols={2}>
  <Card title="Credit Cost"> 1 per call</Card>
  <Card title="Processing"> Realtime</Card>
</CardGroup>

The Hyperliquid info endpoint with `type: "activeAssetData"` is used to fetch a user's active trading limits, leverage setting, available size, and mark price for a single Hyperliquid perpetual asset.

<Tip>
  Estimate your monthly cost for this API using the [Pricing Calculator](/pricing-calculator?endpoint=%2Fapi-reference%2Fhyperliquid-info%2Factive-asset-data).
</Tip>

<Info>
  * Wire-equal to `POST api.hyperliquid.xyz/info` with `{"type": "activeAssetData", "user": "...", "coin": "ETH"}`.
  * `coin` accepts the Hyperliquid asset identifier for the target perp market. For HIP-3 markets, pass the same dex-qualified coin string used by Hyperliquid for that asset.
  * `maxTradeSzs` and `availableToTrade` are returned as two directional decimal-string values. Preserve the upstream array order and use fixed-precision decimal handling.
  * For whole-account position and margin state, use `clearinghouseState`; this endpoint is scoped to one user and one active asset.
</Info>

Returns per-user, per-asset trading state for one active perpetual market: the user's leverage setting, directional max trade sizes, directional available-to-trade amounts, and the current mark price.

User-keyed and coin-keyed. Use this when a trading UI needs to show how much size a wallet can open or close on a specific asset before placing an order. For full account margin and open positions, use [clearinghouseState](https://goldrush.dev/docs/api-reference/hyperliquid-info/clearinghouse-state); for market metadata and asset context, use [metaAndAssetCtxs](https://goldrush.dev/docs/api-reference/hyperliquid-info/meta-and-asset-ctxs).

## Endpoint

```
POST https://hypercore.goldrushdata.com/info
Authorization: Bearer <GOLDRUSH_API_KEY>
Content-Type: application/json
```

## Request

<ParamField body="type" type="string" required default="activeAssetData">
  Always `"activeAssetData"`.
</ParamField>

<ParamField body="user" type="string" required>
  The wallet address (lowercase 0x-prefixed hex).
</ParamField>

<ParamField body="coin" type="string" required>
  The perp asset identifier, e.g. `"ETH"` or `"APT"`. For HIP-3 markets, pass the same dex-qualified coin string used by Hyperliquid for that asset.
</ParamField>

### Example

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://hypercore.goldrushdata.com/info \
    -H "Authorization: Bearer $GOLDRUSH_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "type": "activeAssetData",
      "user": "0xb65822a30bbaaa68942d6f4c43d78704faeabbbb",
      "coin": "APT"
    }'
  ```

  ```typescript TypeScript theme={null}
  const response = await fetch("https://hypercore.goldrushdata.com/info", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.GOLDRUSH_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      type: "activeAssetData",
      user: "0xb65822a30bbaaa68942d6f4c43d78704faeabbbb",
      coin: "APT",
    }),
  });

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

  ```python Python theme={null}
  import os, requests

  response = requests.post(
      "https://hypercore.goldrushdata.com/info",
      headers={"Authorization": f"Bearer {os.environ['GOLDRUSH_API_KEY']}"},
      json={
          "type": "activeAssetData",
          "user": "0xb65822a30bbaaa68942d6f4c43d78704faeabbbb",
          "coin": "APT",
      },
  )

  active_asset = response.json()
  ```
</CodeGroup>

## Response

A single JSON object with the user's active trading configuration and directional trading capacity for the requested asset.

```json theme={null}
{
  "user": "0xb65822a30bbaaa68942d6f4c43d78704faeabbbb",
  "coin": "APT",
  "leverage": {
    "type": "cross",
    "value": 3
  },
  "maxTradeSzs": ["24836370.4400000013", "24836370.4400000013"],
  "availableToTrade": ["37019438.0284740031", "37019438.0284740031"],
  "markPx": "4.4716"
}
```

### Field descriptions

<Note>
  Prices, sizes, and available amounts are returned as **decimal strings**, preserving upstream precision. Do not parse them as floats - keep them as strings or use a fixed-precision decimal type.
</Note>

<ResponseField name="user" type="string">
  Wallet address the active asset data was computed for.
</ResponseField>

<ResponseField name="coin" type="string">
  Hyperliquid asset identifier, such as `"APT"` or `"ETH"`.
</ResponseField>

<ResponseField name="leverage" type="object">
  User's configured leverage for this asset.

  <Expandable title="properties">
    <ResponseField name="type" type="string">Leverage mode, usually `"cross"` or `"isolated"`.</ResponseField>
    <ResponseField name="value" type="int">Configured leverage multiplier.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="maxTradeSzs" type="array<string>">
  Directional maximum trade sizes for this wallet and asset, returned as decimal strings.
</ResponseField>

<ResponseField name="availableToTrade" type="array<string>">
  Directional available-to-trade amounts for this wallet and asset, returned as decimal strings.
</ResponseField>

<ResponseField name="markPx" type="string">
  Current mark price for the asset.
</ResponseField>

## Related endpoints

<CardGroup cols={2}>
  <Card title="metaAndAssetCtxs" href="/api-reference/hyperliquid-info/meta-and-asset-ctxs">fetch the full Hyperliquid perpetuals market universe with live per-asset trading context.</Card>
  <Card title="spotMetaAndAssetCtxs" href="/api-reference/hyperliquid-info/spot-meta-and-asset-ctxs">fetch the spot universe metadata, token configuration, and live market data in a single call.</Card>
</CardGroup>

*Last reviewed: 2026-07-08*