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

# Bitvavo — Setup and Operation

> Netherlands-based EU-regulated venue with EUR-quoted markets. Recommended starter for EU operators wanting EUR exposure throughout.

<Info>
  **Bitvavo is a Netherlands-based EU-regulated venue with EUR-quoted markets natively.** Strong MiCA compliance posture. Recommended EU starter for operators wanting EUR quotes throughout — natural for tax reporting, no FX conversion needed.
</Info>

## When Bitvavo makes sense

<CardGroup cols={2}>
  <Card title="You're an EU resident" icon="circle-euro">
    Bitvavo is purpose-built for EU operators. Strong regulatory standing under MiCA.
  </Card>

  <Card title="You want EUR-quoted trading" icon="money-bill-1">
    Native EUR pairs (`BTC-EUR`, `ETH-EUR`). No USD↔EUR FX conversion. Natural for EU tax reporting.
  </Card>

  <Card title="As recommended EU starter" icon="seedling">
    For first-month EU operators wanting MiCA compliance from day one.
  </Card>

  <Card title="Solid liquidity on majors" icon="droplet">
    Strong on `BTC-EUR`, `ETH-EUR`, top altcoin pairs. Less deep than global Binance but sufficient.
  </Card>
</CardGroup>

## When NOT to use Bitvavo

<Warning>
  * ❌ **You want USDT-quoted trading** — Bitvavo is EUR-native; USDT pairs available but not the focus.
  * ❌ **You're not an EU resident** — Bitvavo restricted outside EU.
  * ❌ **You want very long-tail altcoin coverage** — Bitvavo's listing is curated for EU compliance, not breadth.
  * ❌ **You want sub-cent fees** — Bitvavo's `0.25%` taker is higher than Binance with BNB discount.
</Warning>

## Account creation

<Steps>
  <Step title="Sign up at Bitvavo">
    EU-resident verification required.
  </Step>

  <Step title="Verify email and phone">
    Standard verification with EU phone preferred.
  </Step>

  <Step title="Complete KYC">
    EU-specific KYC. Government ID, address, residence verification.
  </Step>

  <Step title="Enable 2FA">
    Authenticator app preferred.
  </Step>
</Steps>

## API key creation

<Steps>
  <Step title="Navigate to API settings">
    Account → API.
  </Step>

  <Step title="Create new API key">
    Standard creation flow.
  </Step>

  <Step title="Configure permissions">
    * ✅ **View / Read** — enable.
    * ✅ **Trade** — enable.
    * ❌ **Withdrawal** — leave unchecked. NEVER enable.
  </Step>

  <Step title="Set IP allowlist">
    Paste your VPS IP. Wait for propagation.
  </Step>

  <Step title="Save key and secret">
    Save both immediately.
  </Step>
</Steps>

## Connecting unCoded to Bitvavo

<Steps>
  <Step title="Open Dashboard, add Bitvavo">
    "Exchanges" → "Add Exchange" → "Bitvavo."
  </Step>

  <Step title="Paste credentials">
    API key + secret. Test Connection.
  </Step>

  <Step title="Configure EUR pairs">
    Common pairs: `BTC-EUR`, `ETH-EUR`, `SOL-EUR`. Mode pre-builts assume USDT — capital sizing translates roughly 1:1 EUR:USD for nominal value purposes.
  </Step>
</Steps>

## Bitvavo-specific quirks

<AccordionGroup>
  <Accordion title="EUR-quoted natively" icon="money-bill-1">
    Most pairs are `<base>-EUR`. USDT pairs available but not the focus.

    **Operator implication for tax reporting**: Bitvavo's trade history is already in EUR. unCoded's tax export's USD↔EUR conversion is not needed for Bitvavo trades; the data is already EUR-native.
  </Accordion>

  <Accordion title="Symbol naming uses dashes" icon="font">
    Bitvavo pairs use dash separation: `BTC-EUR`, `ETH-EUR`. Same format as OKX/Coinbase/KuCoin/BingX.
  </Accordion>

  <Accordion title="Higher fees than Binance" icon="coins">
    `0.25%` taker default, with volume tier discounts. Higher than Binance with BNB discount.

    **Trade-off**: pay more in fees for EU regulatory standing and EUR-native trading.
  </Accordion>

  <Accordion title="Curated listing" icon="boxes-stacked">
    Smaller symbol set than global majors — typically `100–200` pairs. EU compliance-focused listing.

    Most operators don't need broader coverage. Use a secondary venue (Binance via global, KuCoin, etc.) if you need long-tail altcoins.
  </Accordion>

  <Accordion title="MiCA compliance posture" icon="shield">
    Strong compliance under EU framework. Expect periodic KYC re-verifications. Tax reporting integration with EU tax authorities improving.
  </Accordion>

  <Accordion title="Mode capital sizing in EUR" icon="circle-euro">
    Pre-built modes specify USD-denominated capital. For Bitvavo, treat the recommended numbers as roughly EUR-equivalent for sizing purposes.

    Example: BasicMode's `~$20,000` recommended capital ≈ `~€18,000–22,000` depending on FX rate.
  </Accordion>
</AccordionGroup>

## Troubleshooting Bitvavo-specific

<AccordionGroup>
  <Accordion title="Authentication fails" icon="circle-exclamation">
    Standard checks: IP allowlist, permissions, credential whitespace, propagation.
  </Accordion>

  <Accordion title="Symbol not found" icon="font">
    Use dash format with EUR (`BTC-EUR`). Verify symbol is on Bitvavo (curated listing).
  </Accordion>

  <Accordion title="Higher-than-expected fee impact on strategy" icon="coins">
    `0.25%` taker means strategies that work at `0.075%` (Binance + BNB) may underperform on Bitvavo. Backtest with realistic Bitvavo fees before deploying.
  </Accordion>
</AccordionGroup>

## Best practices for Bitvavo operators

<Tip>
  * ✅ **Use EUR-quoted pairs** as primary — native to Bitvavo.
  * ✅ **API permissions: View + Trade only** — never Withdrawal.
  * ✅ **IP allowlist**.
  * ✅ **2FA with authenticator app**.
  * ✅ **Backtest with `0.25%` fees** to validate strategy economics.
  * ✅ **Pair with Bybit EU** for full MiCA-compliant dual-venue setup.
  * ✅ **Capital sizing in EUR** roughly equivalent to mode-recommended USD amounts.
  * ✅ **Quarterly rotation**.
  * ✅ **Tax reporting natively EUR** — simpler than translating from USDT pairs.
</Tip>

## What's next

<CardGroup cols={2}>
  <Card title="API Key Security" icon="shield" href="/exchanges/api-key-security">
    Universal principles.
  </Card>

  <Card title="Bybit EU Setup" icon="building-columns" href="/exchanges/bybiteu">
    The other recommended EU venue. Common pairing.
  </Card>

  <Card title="Other venues" icon="ellipsis" href="/exchanges/other-venues">
    Remaining production-ready venues.
  </Card>

  <Card title="Tax Export" icon="file-invoice" href="/operations/tax-export">
    EU operators benefit from Bitvavo's EUR-native trade history.
  </Card>

  <Card title="TradingBot" icon="robot" href="/modules/tradingbot">
    The execution engine.
  </Card>
</CardGroup>
