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

Grab a key from the Feeds section of the Goldsky dashboard, or get one from the Goldsky API. 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://edge.goldsky.com/data/feeds/wallets/balances?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&key=$GOLDSKY_FEEDS_API_KEY"

// Node.js 18+, saved as balances.mjs
const url = new URL("https://edge.goldsky.com/data/feeds/wallets/balances");
url.searchParams.set("address", "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045");

const res = await fetch(url, {
  headers: { "X-API-Key": process.env.GOLDSKY_FEEDS_API_KEY },
});
if (!res.ok) throw new Error(`Feeds request failed: ${res.status}`);
const { total_value_usd, data } = await res.json();

console.log(`Total: $${total_value_usd.toFixed(2)}`);
for (const row of data.slice(0, 5)) {
  console.log(row.chain, row.token_symbol, row.value_usd);
}

import os

import requests

res = requests.get(
    "https://edge.goldsky.com/data/feeds/wallets/balances",
    params={"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"},
    headers={"X-API-Key": os.environ["GOLDSKY_FEEDS_API_KEY"]},
    timeout=30,
)
res.raise_for_status()
body = res.json()

print(f"Total: ${body['total_value_usd']:.2f}")
for row in body["data"][:5]:
    print(row["chain"], row["token_symbol"], row["value_usd"])

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://edge.goldsky.com/data/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.

Prompt a coding agent

To have Claude Code, Cursor, or another coding agent build on Feeds, paste this prompt and replace the last line with what you want to build:

Help me build with the Goldsky Feeds API: wallet balances and transfers across EVM chains over REST.

- Base URL: https://edge.goldsky.com/data/feeds/wallets (endpoints: /balances and /transfers)
- Read the OpenAPI spec first. It's the source of truth for parameters and response fields: https://edge.goldsky.com/data/openapi.json (the /feeds/wallets endpoints).
- Docs: https://docs.goldsky.com/feeds
- My Feeds API key is in the GOLDSKY_FEEDS_API_KEY environment variable. It is not the Goldsky API token. Send it in the X-API-Key header, never hard-code it, and call the API from server code, not the browser.
- One wallet address per request. Follow pagination.next_page_token until it is null.

Build: a script that prints a wallet's total USD value and its 10 largest holdings.

For the Feeds skill, the docs MCP server, and OpenAPI tool generation, see Build with agents.

Feeds

Reference

Get started with Feeds

Prerequisites

Prompt a coding agent

Next steps

Balances reference

Transfers reference

​Prerequisites

​Prompt a coding agent

​Next steps

Balances reference

Transfers reference

Prerequisites

Prompt a coding agent

Next steps