goldrush-foundational-api

Name: goldrush-foundational-api
Author: covalenthq

github.com/covalenthqData & databases4125 installsUpdated 34w ago

About goldrush-foundational-api

GoldRush Foundational API is a skill for developers working with blockchain data through a REST API and TypeScript SDK. It covers historical and near-real-time endpoints across 100+ chains, including balances, transactions, NFTs, security, cross-chain activity, and block data.

Key features

01Query multichain token balances and transactions
02Retrieve NFT holdings and approval details
03Look up cross-chain activity and multichain balances
04Fetch prices, blocks, and event logs
05Use the TypeScript SDK or raw HTTP requests

Use cases

01Check wallet balances and transaction history
02Verify NFT ownership and token approvals
03Analyze cross-chain wallet activity
04Query balances or events at a specific block

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/covalenthq/goldrush-agent-skills --skill goldrush-foundational-api

After installing, type/goldrush-foundational-apiin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/

endpoints-balances.md

endpoints-nft-security-crosschain.md

endpoints-transactions.md

endpoints-utility.md

integration-guide.md

overview.md

workflows.md

Details

From the project README

GoldRush Foundational API

REST API providing historical and near-real-time blockchain data across 100+ chains. Endpoints cover token balances, transactions, NFTs, security approvals, cross-chain activity, pricing, and block data.

Quick Start

IMPORTANT: Always prioritize using the official available GoldRush Client SDK best suited for your development ecosystem:

TypeScript Client SDK

import { GoldRushClient } from "@covalenthq/client-sdk";

const client = new GoldRushClient("YOUR_API_KEY");

const resp = await client.BalanceService.getTokenBalancesForWalletAddress(
  "eth-mainnet",
  "demo.eth"
);

if (!resp.error) {
  console.log(resp.data.items);
} else {
  console.error(resp.error_message);
}

Install: npm install @covalenthq/client-sdk

Raw HTTP:

curl "https://api.covalenthq.com/v1/eth-mainnet/address/demo.eth/balances_v2/" \
  -H "Authorization: Bearer YOUR_API_KEY"

Endpoint Categories

Endpoints are organized into categories. Each links to its reference file with full parameters, response schemas, and use cases.

Balances — token balances, native balances, historical balances, portfolio value, ERC20 transfers, token holders, Bitcoin (HD and non-HD). See endpoints-balances.md.
Transactions — recent transactions, paginated history, single transaction lookup, summaries, block-level transactions, Bitcoin transactions. See endpoints-transactions.md.
NFT, Security & Cross-Chain — NFT holdings, ownership verification, token/NFT approvals, address activity, multi-chain balances and transactions. See endpoints-nft-security-crosschain.md.
Utility — token prices, blocks, block heights, event logs, gas prices, chain metadata, pool spot prices, address resolution. See endpoints-utility.md.

Common Tasks → Endpoint

Task	Endpoint
Check wallet balance	`getTokenBalancesForWalletAddress`
Get native token only (lightweight)	`getNativeTokenBalance`
Get recent transactions	`getRecentTransactionsForAddress`
Get full transaction history	`getTransactionsForAddressV3` (paginated)
Look up a single transaction	`getTransaction`
Get ERC20 transfer history	`getErc20TransfersForWalletAddress`
Get transaction summary/count	`getTransactionSummary`
Check token approvals (security)	`getApprovals`
Get NFT holdings	`getNftsForAddress`
Verify NFT ownership	`checkOwnershipInNft`
Get portfolio value over time	`getHistoricalPortfolioForWalletAddress`
Get balance at a specific block	`getHistoricalTokenBalancesForWalletAddress`
Get token price history	`getTokenPrices`
Find which chains a wallet is active on	`getAddressActivity`
Get balances across all chains	`getMultiChainBalances`
Get token holders	`getTokenHoldersV2ForTokenAddress`
Get Bitcoin balance (HD wallet)	`getBitcoinBalancesForHdAddress`
Get contract event logs	`getLogEventsByAddress`
Get block details	`getBlock`

Critical Rules

Chain names are case-sensitive — use eth-mainnet, not ethereum or Eth-Mainnet
Authentication — Authorization: Bearer YOUR_API_KEY (HTTPS only)
Pagination is 0-indexed — first page is 0, 100 items per page
Always check resp.error before accessing resp.data
Token balances are strings — divide by 10^contract_decimals for human-readable values
ENS/domain resolution — pass vitalik.eth directly as the wallet address
Foundational-only features — historical balances, token holders at any block, pool spot prices, tracing flags
Quote currency — defaults to USD; supported: USD, CAD, EUR, SGD, INR, JPY, and more
Spam filtering — use no-spam=true query parameter to filter spam tokens
SDK handles retries — the TypeScript SDK has built-in retry logic and rate limit handling

Reference Files

Read the relevant reference file when you need details beyond what this index provides.

File	When to read
overview.md	Need API setup details, authentication methods, or SDK quickstart code
endpoints-balances.md	Building a balance query — parameters, response schema, Bitcoin-specific endpoints
endpoints-transactions.md	Building a transaction query — pagination, decoded logs, block-level queries
endpoints-nft-security-crosschain.md	Need NFT metadata, token approvals, or cross-chain activity lookups
endpoints-utility.md	Need block data, event logs, gas prices, token prices, or chain metadata
integration-guide.md	Need full chain names table, validation rules, error codes, or FAQ answers
workflows.md	Planning a multi-step workflow or debugging a common error

Comments

Markdown supported

Details

Author: covalenthq
Repository: covalenthq/goldrush-agent-skills
Category: Data & databases
Installs: 125
GitHub stars: 4

Report

More skills

All skills

hyperframes-core

github.com/heygen-com

930.7k

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition HTML.

lark-base

open.feishu.cn

837.7k

Operate on Feishu Base: create tables, fields, records, and views; handle statistics, formulas/lookups, forms, dashboards, app mode (BaseApp/AppMode pages and components), Workspace directories, workflows, role permissions, and the template center (Base template categories, lists, and search). Use when encountering Base/multidimensional tables/bitable, BaseApp/AppMode, or /base/ or /app/ links. Do not use lark-apps for BaseApp; route file import/export to lark-drive and authentication/authorization to lark-shared.

lark-sheets

open.feishu.cn

836.2k

Feishu Spreadsheets: create and operate spreadsheets. Supports worksheets and row/column structures (add/delete/merge/size/hide/freeze/group), cell read/write (values/formulas/styles/comments/cell images), range copy/move/sort/fill, find and replace, bulk updates, and creating and maintaining objects such as charts, pivot tables, conditional formatting, filters and filter views, dropdown lists, sparklines, and floating images. Also supports formula validation, restoring historical versions, and importing/exporting local Excel/CSV files and Feishu spreadsheets. Use when users need to create or edit spreadsheets, summarize and visualize data, format spreadsheets, calculate formulas (including migrating Excel formulas), or build financial models (DCF, three statements, budgets, Sensitivity, etc.). For multidimensional tables (Base/bitable), use lark-base. If users want to search for spreadsheet files in cloud storage (Drive/cloud storage) by name or keyword, use lark-drive's drive +search to locate resources first. When users provide a doubao.com /sheets/ URL/token, use this skill directly; do not fall back to WebFetch because the domain is not Feishu. Routing is based on the URL path pattern and token, not the domain.

remotion-best-practices

github.com/remotion-dev

720.7k

Best practices and domain knowledge for building videos programmatically with Remotion (videos in React/TypeScript, rendered to MP4). Use whenever writing or editing Remotion code — scaffolding a video project, animating with interpolate/spring over useCurrentFrame(), sequencing scenes and transitions, captions/subtitles, audio, GIFs/Lottie/3D, charts, visual effects, dynamic duration via calculateMetadata, or rendering. Consult before reaching for a Remotion API, since its components and props evolve (e.g. @remotion/media).