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

# Quickstart

> Get started with the Wallbit API in minutes

## Get started in three steps

Make your first API call and start building with Wallbit.

### Step 1: Get your API Key

<AccordionGroup>
  <Accordion icon="key" title="Create an API Key">
    1. Log in to your Wallbit account (in the app or in the [Wallbit
       Dashboard](https://developer.wallbit.io/dashboard)) 2. Navigate to
       **Agents** 3. Click **Create agent** 4. Select the permissions you need: -
       `read` - Query balances and transactions - `trade` - Execute buy/sell orders
    2. Copy and securely store your API key

    <Warning>
      Your API key will only be shown once. Store it securely and never commit
      it to version control.
    </Warning>
  </Accordion>
</AccordionGroup>

### Step 2: Make your first request

<AccordionGroup>
  <Accordion icon="terminal" title="Test with cURL">
    Try fetching your checking account balance:

    ```bash theme={null}
    curl -X GET "https://api.wallbit.io/api/public/v1/balance/checking" \
      -H "X-API-Key: your_api_key_here"
    ```

    You should receive a response like:

    ```json theme={null}
    {
      "data": [
        {
          "currency": "USD",
          "balance": 1000.50
        }
      ]
    }
    ```

    <Tip>Replace `your_api_key_here` with your actual API key.</Tip>
  </Accordion>

  <Accordion icon="code" title="Use in your code">
    <CodeGroup>
      ```javascript Node.js theme={null}
      const response = await fetch('https://api.wallbit.io/api/public/v1/balance/checking', {
        headers: {
          'X-API-Key': process.env.WALLBIT_API_KEY
        }
      });

      const { data } = await response.json();
      console.log('Balances:', data);
      ```

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

      response = requests.get(
          'https://api.wallbit.io/api/public/v1/balance/checking',
          headers={'X-API-Key': os.environ['WALLBIT_API_KEY']}
      )

      data = response.json()['data']
      print('Balances:', data)
      ```

      ```bash cURL theme={null}
      curl -X GET "https://api.wallbit.io/api/public/v1/balance/checking" \
        -H "X-API-Key: $WALLBIT_API_KEY"
      ```
    </CodeGroup>
  </Accordion>
</AccordionGroup>

### Step 3: Explore more endpoints

<Accordion icon="rocket" title="What's next?">
  Now that you've made your first request, explore what else you can do: - **Get
  your stock portfolio**: `GET /api/public/v1/balance/stocks` - **List
  transactions**: `GET /api/public/v1/transactions` - **Execute a trade**: `POST
      /api/public/v1/trades` - **Look up trading fees**: `POST /api/public/v1/fees`
  (requires `read`) - **Browse available assets**: `GET /api/public/v1/assets`
</Accordion>

## Next steps

Now that you have your API key working, explore these key features:

<CardGroup cols={2}>
  <Card title="Balance" icon="wallet" href="/api-reference/balance/checking">
    Query your checking and investment balances.
  </Card>

  <Card title="Trades" icon="chart-line" href="/api-reference/trades/create">
    Buy and sell stocks programmatically.
  </Card>

  <Card title="Fees" icon="percent" href="/api-reference/fees/get">
    Read fee configuration for your subscription tier.
  </Card>

  <Card title="Transactions" icon="receipt" href="/api-reference/transactions/list">
    View your complete transaction history.
  </Card>

  <Card title="Rates" icon="arrow-right-arrow-left" href="/api-reference/rates/get">
    Look up fiat exchange rates between currency pairs.
  </Card>

  <Card title="Assets" icon="chart-pie" href="/api-reference/assets/list">
    Browse available stocks and ETFs.
  </Card>
</CardGroup>

<Note>
  **Need help?** Contact our support team at
  [support@wallbit.io](mailto:support@wallbit.io) or visit our [Help
  Center](https://help.wallbit.io).
</Note>