Feeds Quickstart - Goldsky Docs

This quickstart gets a wallet’s balances and transfers from the Feeds REST API, then looks up token prices, in four steps. It ends with requests to the Prediction markets and Chain datasets feeds, which use the same key.

Prerequisites

A Goldsky account

Get your API key

Open Feeds in the Goldsky dashboard and create or copy a key on the API keys tab. You can also get one from the Goldsky API or the CLI. 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.

Look up token prices

Request the metadata and current USD price of USDC on Ethereum and ETH on Base. Pass up to 100 chain:token_address pairs, and use the zero address for a chain’s native token:

curl "https://edge.goldsky.com/data/feeds/tokens?tokens=ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48,base:0x0000000000000000000000000000000000000000&key=$GOLDSKY_FEEDS_API_KEY"

You get one entry per token, in the order you asked for them:

{
  "data": [
    {
      "chain": "ethereum",
      "chain_family": "evm",
      "token_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "token_symbol": "USDC",
      "token_name": "USD Coin",
      "token_decimals": 6,
      "token_logo_url": "https://coin-images.coingecko.com/coins/images/6319/large/USDC.png?1769615602",
      "price_usd": 1.0,
      "last_priced_at": null
    },
    {
      "chain": "base",
      "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",
      "price_usd": 2327.073745074987,
      "last_priced_at": "2026-10-27T00:31:00.000Z"
    }
  ]
}

USDC has a price but no last_priced_at because major stablecoins are priced at 1.0. The response has no pagination.

Each successful Balances, Transfers, or Tokens request is billed as one request, at $0.35 per 1,000. A Tokens request costs the same whether it looks up one token or 100. Or pay per request in USDC with x402, with no Goldsky account or API key.

Try the other feeds

The same key works for the Prediction markets and Chain datasets feeds. You can also try them from their cards on the dashboard’s Feeds page, which open a request builder and a preview. These feeds page with limit and cursor instead of page_size and page_token. See pagination. Get a wallet’s three largest Polymarket positions:

curl -H "X-API-Key: $GOLDSKY_FEEDS_API_KEY" \
  "https://edge.goldsky.com/data/polymarket/positions?address=0x0000000000002d4249a9b7976dc47d3cff1a54a2&limit=3"

Find the newest Ethereum block at or before a Unix timestamp:

curl -H "X-API-Key: $GOLDSKY_FEEDS_API_KEY" \
  "https://edge.goldsky.com/data/blocks/ethereum?timestamp_lte=1783820990&sort=number_desc&limit=1"

These feeds bill one compute unit per row returned, at $10 per million. Or pay per request in USDC with x402, with no Goldsky account or API key. See Feeds pricing.

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, plus token metadata and prices, across EVM chains over REST.

- Base URL: https://edge.goldsky.com/data (endpoints: /feeds/wallets/balances, /feeds/wallets/transfers, and /feeds/tokens)
- The same key also serves Polymarket data (/polymarket/activity, /polymarket/positions, /polymarket/balances) and block headers (/blocks/{chain}, /blocks/{chain}/head). Those page with limit and cursor, not page_size and page_token.
- Read the OpenAPI spec first. It's the source of truth for parameters and response fields: https://edge.goldsky.com/data/openapi.json
- 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.
- The wallet endpoints take one wallet address per request. Follow pagination.next_page_token until it is null.
- /tokens takes up to 100 chain:token_address pairs in the tokens parameter (zero address for a native token) and returns them in request order, with no pagination.

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.

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.

Tokens reference

Look up metadata and current USD prices for up to 100 tokens.

Prediction markets reference

Polymarket activity, positions, and balances.

Chain datasets reference

Block headers and chain head on 21 chains.

Feeds

Reference

Get started with Feeds

Prerequisites

Try the other feeds

Prompt a coding agent

Next steps

Balances reference

Transfers reference

Tokens reference

Prediction markets reference

Chain datasets reference

​Prerequisites

​Try the other feeds

​Prompt a coding agent

​Next steps

Balances reference

Transfers reference

Tokens reference

Prediction markets reference

Chain datasets reference

Prerequisites

Try the other feeds

Prompt a coding agent

Next steps