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

# Get started with Feeds

> Create a Feeds API key in the Goldsky dashboard and make your first Balances and Transfers requests for a wallet.

This quickstart gets a wallet's balances and transfers from the Feeds REST API in three steps.

## Prerequisites

* A [Goldsky account](https://app.goldsky.com)

<Steps>
  <Step title="Get your API key">
    Open [Feeds in the Goldsky dashboard](https://app.goldsky.com/dashboard/feeds), go to [**API Keys**](https://app.goldsky.com/dashboard/feeds?tab=api-keys), and select **Create API key**. If you run a test request in the dashboard first, it creates a key for you. One key works for every feed in your project.

    This is a Feeds API key, not the Goldsky API key the CLI uses.

    Save the key in your server's environment:

    ```bash theme={"dark"}
    export GOLDSKY_FEEDS_API_KEY=your-api-key
    ```
  </Step>

  <Step title="Get balances for a wallet">
    Request the balances for a wallet:

    ```bash theme={"dark"}
    curl "https://api.goldsky.com/api/v1/feeds/wallets/balances?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&key=$GOLDSKY_FEEDS_API_KEY"
    ```

    The response has the wallet's total value and one row per token, highest value first. This one is shortened to its first row:

    ```json theme={"dark"}
    {
      "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
      "total_value_usd": 25260.2792825334,
      "data": [
        {
          "chain": "ethereum",
          "chain_family": "evm",
          "token_address": "0x0000000000000000000000000000000000000000",
          "token_symbol": "ETH",
          "token_name": "Ether",
          "token_decimals": 18,
          "token_logo_url": "https://coin-images.coingecko.com/coins/images/279/large/ethereum.png?1696501628",
          "balance_raw": "5715987139328012679",
          "price_usd": 2668.616188843224,
          "last_priced_at": "2026-09-30T08:19:00.000Z",
          "value_usd": 15253.775815230401,
          "block_number": 26089058,
          "block_timestamp": "2026-09-30T08:19:59.000Z"
        }
      ],
      "pagination": {
        "next_page_token": "eyJzIjoidmFsdWVfdXNkIiwiayI6IiIsInQiOiJi...",
        "prev_page_token": null,
        "page_size": 100
      }
    }
    ```
  </Step>

  <Step title="Get transfers for a wallet">
    Request the transfer history for the same wallet:

    ```bash theme={"dark"}
    curl "https://api.goldsky.com/api/v1/feeds/wallets/transfers?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&key=$GOLDSKY_FEEDS_API_KEY"
    ```

    You get the wallet's transfers across every supported chain, newest first, 100 per page. This one is shortened to its first row:

    ```json theme={"dark"}
    {
      "data": [
        {
          "chain": "ethereum",
          "chain_family": "evm",
          "block_number": 26088909,
          "block_timestamp": "2026-09-30T07:49:59.000Z",
          "transaction_hash": "0x1a4b7361a7700a95158ab51ace260ad29089c37144348f892af384b193e90159",
          "from_address": "0xc2363b7155ee8391c5395b72c46a6d22bf49151c",
          "to_address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
          "from_label": null,
          "to_label": null,
          "direction": "in",
          "token_address": "0x6b175474e89094c44da98b954eedeac495271d0f",
          "token_symbol": "DAI",
          "token_name": "Dai",
          "token_decimals": 18,
          "token_logo_url": "https://coin-images.coingecko.com/coins/images/9956/large/Badge_Dai.png?1696509996",
          "amount_raw": "9800000000000000000",
          "price_usd": 1.0,
          "amount_usd": 9.8,
          "transfer_type": "erc20"
        }
      ],
      "pagination": {
        "next_page_token": "eyJzIjoiYmxvY2tfdGltZXN0YW1wX2Rlc2MiLCJr...",
        "prev_page_token": null,
        "page_size": 100
      }
    }
    ```

    To get the next page, pass `pagination.next_page_token` back as `page_token`.
  </Step>
</Steps>

Each successful request is billed as one request, at \$0.35 per 1,000.

## Next steps

<CardGroup cols={2}>
  <Card title="Balances reference" icon="wallet" href="/feeds/api/balances" arrow>
    Filter by chain or token, hide dust, and page through holdings.
  </Card>

  <Card title="Transfers reference" icon="arrow-left-right" href="/feeds/api/transfers" arrow>
    Filter by direction, transfer type, time, or block range.
  </Card>
</CardGroup>


## Related topics

- [Introduction to Goldsky](/introduction.md)
- [Feeds](/feeds.md)
- [Feeds API overview](/feeds/api/overview.md)
- [Stream Feeds to your database](/feeds/streaming.md)
- [Benefits](/benefits.md)