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

# BitMart — Setup and Operation

> Global venue with broad listings. Unique requirement: API_UID memo field in addition to key+secret.

<Info>
  **BitMart is a global venue with broad symbol listings.** Distinguishing feature: BitMart requires an `API_UID` (sometimes called "memo") field in addition to API key and secret. Save all three credentials at creation — the API\_UID is unrecoverable.
</Info>

## When BitMart makes sense

<CardGroup cols={2}>
  <Card title="Symbol coverage beyond majors" icon="boxes-stacked">
    BitMart lists tokens not on Binance/Bybit, particularly Asian-market and earlier-stage projects.
  </Card>

  <Card title="Tertiary venue diversification" icon="puzzle-piece">
    For operators running multiple venues for jurisdictional/symbol diversification.
  </Card>

  <Card title="Specific niche listings" icon="circle-dot">
    Useful when you've identified a specific symbol with good BitMart liquidity.
  </Card>
</CardGroup>

## When NOT to use BitMart

<Warning>
  * ❌ **As your starter venue** — established majors better.
  * ❌ **As your only venue** — variable liquidity outside top pairs.
  * ❌ **For US residents** — BitMart has US restrictions.
  * ❌ **For operators new to multi-credential setups** — API\_UID adds complexity. Master Binance/Bybit first.
</Warning>

## Important: API\_UID requirement

<AccordionGroup>
  <Accordion title="What API_UID is" icon="key">
    BitMart's third credential beyond key and secret. Sometimes labeled "memo" in BitMart's UI.

    **Not** a passphrase like OKX (passphrases are operator-set; UID is system-assigned). It identifies the API key uniquely within BitMart's authentication system.
  </Accordion>

  <Accordion title="Save at creation" icon="floppy-disk">
    Save all three (key, secret, UID) immediately. UID is unrecoverable — losing it means revoke and recreate.
  </Accordion>

  <Accordion title="Don't confuse with OKX passphrase" icon="circle-info">
    OKX uses passphrase (operator-chosen). BitMart uses API\_UID (system-assigned). Both are "third credential" but different concepts.
  </Accordion>
</AccordionGroup>

## Account creation

<Steps>
  <Step title="Sign up at BitMart">
    Standard signup.
  </Step>

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

  <Step title="Complete KYC">
    KYC for spot trading.
  </Step>

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

## API key creation

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

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

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

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

  <Step title="Save key, secret, AND API_UID (memo)">
    All three needed. Save all to password manager **before doing anything else**.
  </Step>
</Steps>

## Connecting unCoded to BitMart

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

  <Step title="Paste all three credentials">
    BitMart form has three fields: API Key, Secret, API\_UID (or memo). Paste all three.
  </Step>

  <Step title="Test connection">
    Authentication failure usually means missing/wrong API\_UID.
  </Step>
</Steps>

## BitMart-specific quirks

<AccordionGroup>
  <Accordion title="API_UID requirement" icon="key">
    Already covered above, but worth re-emphasizing: third credential mandatory. Lose any one of the three = revoke and recreate.
  </Accordion>

  <Accordion title="Symbol naming varies" icon="font">
    BitMart pair format may differ by symbol type. Generally `<base>_<quote>` or similar. The unCoded exchange profile handles known patterns.
  </Accordion>

  <Accordion title="Variable liquidity" icon="droplet">
    Strong on majors; variable on long-tail. Validate per-symbol before configuring.
  </Accordion>

  <Accordion title="Fee structure" icon="coins">
    Default `0.25%` taker. Higher than Binance with BNB. Volume tier discounts available.
  </Accordion>

  <Accordion title="Less battle-tested integration" icon="flask">
    BitMart's unCoded integration is solid but less deeply hand-tuned than Binance/Bybit. Watch logs more carefully.
  </Accordion>
</AccordionGroup>

## Troubleshooting BitMart-specific

<AccordionGroup>
  <Accordion title="Authentication fails with valid-looking credentials" icon="circle-exclamation">
    Most common cause: missing or wrong API\_UID/memo field.

    **Steps**:

    1. Verify all three credentials saved at creation.
    2. Re-paste API\_UID carefully.
    3. Verify IP allowlist matches VPS IP.
    4. Confirm Spot Trading permission enabled.
  </Accordion>

  <Accordion title="I lost the API_UID" icon="key">
    Recovery path:

    1. Revoke the API key at BitMart.
    2. Create new key — note the new API\_UID.
    3. Save all three credentials immediately.
    4. Update Dashboard, restart TradingBot.
  </Accordion>

  <Accordion title="Symbol not found" icon="font">
    Verify symbol format (BitMart-specific) and that the pair is listed.
  </Accordion>
</AccordionGroup>

## Best practices for BitMart operators

<Tip>
  * ✅ **Save key, secret, AND API\_UID at creation** — third credential is unrecoverable.
  * ✅ **Don't confuse API\_UID with OKX-style passphrase** — different concepts.
  * ✅ **API permissions: Read + Spot Trading only** — never Withdrawal.
  * ✅ **IP allowlist** mandatory.
  * ✅ **2FA with authenticator app**.
  * ✅ **Validate per-symbol liquidity** before configuring.
  * ✅ **Use as secondary/tertiary venue**.
  * ✅ **Watch logs** more carefully than majors due to less-tuned integration.
  * ✅ **Quarterly rotation**.
</Tip>

## What's next

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

  <Card title="OKX Setup" icon="building-columns" href="/exchanges/okx">
    Compares with OKX's passphrase model.
  </Card>

  <Card title="Binance Setup" icon="building-columns" href="/exchanges/binance">
    The recommended primary.
  </Card>

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

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