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

# How to Generate Your Hyperliquid Tax Report with KoinX

> Connect your Hyperliquid to KoinX in a few steps to generate and file your Hyperliquid taxes accurately.

<Info>
  **Wallet Address**  ·  **\~2 min**  ·  Perps · Spot · Vault  ·  **100+ countries**
</Info>

## What's covered

<CardGroup cols={2}>
  <Card title="Perps and Futures" color="#0066CC" icon="chart-line">
    All perpetual and futures trade history.
  </Card>

  <Card title="Spot trades" color="#0066CC" icon="arrow-right-arrow-left">
    Spot buy and sell orders.
  </Card>

  <Card title="Vault activity" color="#0066CC" icon="piggy-bank">
    Vault deposits, withdrawals, and rewards.
  </Card>

  <Card title="Trading Fees" color="#0066CC" icon="receipt">
    Fee records across all trade types.
  </Card>
</CardGroup>

## Before you start

<CardGroup cols={2}>
  <Card title="Hyperliquid account" icon="building-columns">
    Active account with trading history at [app.hyperliquid.xyz](https://app.hyperliquid.xyz).
  </Card>

  <Card title="KoinX account" icon="sparkles" href="https://app.koinx.com/get-started">
    Free account - no credit card needed.
  </Card>
</CardGroup>

***

## Connect Hyperliquid to KoinX

**Hyperliquid connects via your public wallet address - no API key or file download needed.**

<Tabs>
  <Tab title="Wallet Address">
    ## Find your Hyperliquid Account Wallet Address

    <Steps>
      <Step title="Log in to Hyperliquid">
        Go to [app.hyperliquid.xyz](https://app.hyperliquid.xyz) and sign in to your account.
      </Step>

      <Step title="Open your account details">
        Click on your **email address or wallet address** in the upper right corner of the screen.
      </Step>

      <Step title="Copy your Account Wallet Address">
        Copy your **Account Wallet Address** from the dropdown.

        <Warning>
          Copy your **Account Wallet Address** only - not your private key. Your private key must never be shared with any platform. KoinX only needs your public wallet address.
        </Warning>
      </Step>
    </Steps>

    ## Connect Hyperliquid to KoinX

    <Steps>
      <Step title="Open KoinX Integrations">
        Log in to [app.koinx.com](https://app.koinx.com) -> **Integrations** -> **Add Integration**.
      </Step>

      <Step title="Select Hyperliquid">
        Search for and select **Hyperliquid**.
      </Step>

      <Step title="Paste your wallet address and import">
        Paste your **Account Wallet Address** into the field and click **Import**. KoinX will automatically fetch your Hyperliquid transactions.
      </Step>
    </Steps>

    <Check>
      **Done.** KoinX reads your Hyperliquid on-chain data, classifies your transactions, and prepares everything for gains calculation and tax report generation.
    </Check>

    Once your Hyperliquid data is in, head over to [Tax Reports](https://app.koinx.com/tax-report) on KoinX - your capital gains across Perps, Spot, and Vault activity are already calculated and your report is ready to file.

    ## Wallet address notes

    <Note>
      * **Public address only** - your Account Wallet Address is public information on the blockchain. Sharing it does not give anyone access to your funds.
      * **No API key or file needed** - Hyperliquid integration works entirely via your public wallet address.
      * **Use Sync Now** to pull the latest Hyperliquid transactions into KoinX at any time from the Integrations panel.
    </Note>
  </Tab>
</Tabs>

***

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Is it safe to share my wallet address with KoinX?">
    Yes. Your Account Wallet Address is public information on the blockchain - sharing it does not give anyone access to your funds. KoinX uses it to read your on-chain transaction history in read-only mode. Never share your private key with any platform.
  </Accordion>

  <Accordion title="Where do I find my Account Wallet Address on Hyperliquid?">
    Click on your email or wallet address in the upper right corner of the Hyperliquid interface. Your Account Wallet Address will be visible in the dropdown panel. Copy it from there.
  </Accordion>

  <Accordion title="Do I need an API key or file download?">
    No. Hyperliquid integration works entirely via your public wallet address. There is no API key to generate and no files to download or upload.
  </Accordion>

  <Accordion title="What transaction types does KoinX import from Hyperliquid?">
    KoinX imports your perpetual futures trades, spot trades, and vault activity by reading your on-chain history linked to your wallet address.
  </Accordion>

  <Accordion title="Does KoinX support my country's crypto tax rules?">
    Yes. KoinX supports 100+ countries with dedicated report formats for India, the US, UK, Australia, Canada, Germany, and more. After importing your Hyperliquid data, select your country to generate the correct report.
  </Accordion>
</AccordionGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="No transactions appearing after import">
    Verify you copied the correct Account Wallet Address from Hyperliquid - not a connected wallet address or private key. Go back to Hyperliquid, re-copy the address from the upper right corner, and re-import in KoinX.
  </Accordion>

  <Accordion title="Some trades appear missing">
    KoinX reads on-chain data which may take a moment to fully index. Wait a few minutes and refresh your KoinX transactions view. If trades are still missing, disconnect and reconnect the integration.
  </Accordion>

  <Accordion title="Import is taking too long">
    Large accounts with long trading histories may take a few minutes to sync. Wait before refreshing. If it has been more than 10 minutes, go to **KoinX** -> **Integrations**, remove the Hyperliquid integration, and re-add it.
  </Accordion>

  <Accordion title="Wrong wallet address was used">
    Go to **KoinX** -> **Integrations** -> **Hyperliquid** -> **Remove**, then repeat the integration steps with the correct Account Wallet Address from Hyperliquid.
  </Accordion>

  <Accordion title="Vault activity is missing from KoinX">
    Trigger a manual re-sync from **KoinX** -> **Integrations** -> **Hyperliquid** using the Sync Now feature. If vault transactions are still missing after syncing, confirm the correct wallet address is connected.
  </Accordion>

  <Accordion title="KoinX is showing duplicate Hyperliquid transactions">
    Check **KoinX** -> **Integrations** for duplicate Hyperliquid connections and remove any extras. Each wallet address should only be added once.
  </Accordion>
</AccordionGroup>

***

## Related integrations

<CardGroup cols={2}>
  <Card title="Bybit Integration" icon="bolt" href="/integration/bybit">
    Connect Bybit via API key or file upload.
  </Card>

  <Card title="Phemex Integration" icon="key" href="/integration/phemex">
    Connect Phemex via API key for automatic sync.
  </Card>

  <Card title="Binance - File Upload" icon="chart-bar" href="/integration/binance">
    Export Binance CSVs for Spot, P2P, Earn, and Options.
  </Card>

  <Card title="Bitget - API Upload" icon="key" href="/integration/bitget">
    Connect Bitget via Tax API Key or Normal API Key.
  </Card>
</CardGroup>

<Card title="Ready to generate your Hyperliquid crypto tax report?" color="#6366f1" icon="rocket" href="https://app.koinx.com/get-started">
  Create a free KoinX account - no credit card required. Connect Hyperliquid with your wallet address and generate a country-specific tax report in minutes.
</Card>