Skip to main content
The easiest way to build with Feeds is to prompt your coding agent with:
This works in Codex, Claude Code, Cursor, Grok, and any other coding agent. The agent reads the spec to learn every feed’s parameters and response fields. Then describe what you want to build. For example:
  • “Show me what 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 holds on Base.”
  • “Build a portfolio endpoint that returns a wallet’s total value and one row per token.”
  • “List this trader’s open Polymarket positions with realized PnL.”
Give the agent a Feeds API key, for example in a GOLDSKY_FEEDS_API_KEY environment variable. See Get an API key. An agent can also get the key from the Goldsky API, or pay for each request itself with x402, with no account or key.
The Feeds API key is not the Goldsky API token. Don’t give an agent that only reads feed data access to the Goldsky API token.

​
More ways to use Feeds from an agent

​
Install the Feeds skill

The Goldsky Agent skill pack includes a feeds skill for Claude Code, Cursor, Windsurf, Codex, and other AI coding assistants. It teaches the assistant how to authenticate, call the Balances, Transfers, and Tokens endpoints, and avoid common mistakes, such as using the Goldsky API token instead of the Feeds key.
See Agent Skills for other install methods and for agents that don’t load skills automatically.

​
Connect the docs MCP server

The Goldsky docs MCP server lets any MCP client search the Goldsky docs, including the Feeds API reference, while it answers. Point your client at:
For clients that use the mcpServers schema, such as Cursor and Claude Code:
See Goldsky MCP server for setup in other clients.

​
Tips for agents

  • Filter by chain when you can. Wallet requests default to every supported chain. Pass chains, such as chains=base, when the user names a chain.
  • Follow pagination. Balances and Transfers page with page_size and page_token. The Prediction markets feeds and Blocks page with limit and cursor, and ignore page_size. See pagination in the API overview.
  • Mind the chain names. Blocks spells Polygon matic, while the wallet feeds spell it polygon. Each group has its own chain list.
  • Scale Polymarket numbers. Positions and Prediction markets Balances return strings in raw units of 10^6. Activity returns plain numbers.
  • Batch token lookups. To price a list of tokens, send up to 100 chain:token_address pairs in one Tokens request instead of one request per token. It costs the same as a request for one token.
Can’t find what you’re looking for? Reach out to us at support@goldsky.com for help.