Feeds Quickstart - Goldsky Docs

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

Prerequisites

A Goldsky account

Get your API key

Open Feeds in the Goldsky dashboard, go to 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:

export GOLDSKY_FEEDS_API_KEY=your-api-key

Get balances for a wallet

Request the balances for a wallet:

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:

{
  "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
  }
}

Get transfers for a wallet

Request the transfer history for the same wallet:

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:

{
  "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.

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

Next steps

Balances reference

Filter by chain or token, hide dust, and page through holdings.

Transfers reference

Filter by direction, transfer type, time, or block range.

Feeds

Reference

Get started with Feeds

Prerequisites

Next steps

Balances reference

Transfers reference

​Prerequisites

​Next steps

Balances reference

Transfers reference

Prerequisites

Next steps