helius-data-queries

helius-data-queries is a cursor rule for coding agents from helius-labs/core-ai. It costs 0 tokens per session (433 once invoked), scanned A, original, MIT.

Coding rules for querying Helius, a service that provides Solana blockchain data. They describe efficient ways to retrieve assets and transaction history and how to type TypeScript requests.

In plain words
What is it for?
Use them when writing Solana data queries, retrieving tokens or NFTs, reading transaction history, batching requests, and adding TypeScript request types.
Why use it?
They reduce unnecessary API calls and help prevent silent errors caused by using the wrong parameter names or filtering data inefficiently.

Cursor rule

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add rules/helius-labs/core-ai/helius-data-queries
Clone the repo
git clone --depth 1 https://github.com/helius-labs/core-ai

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for helius-data-queries

README.md
[![agentmods](https://agentmods.dev/badge/rules/helius-labs/core-ai/helius-data-queries.svg)](https://agentmods.dev/rules/helius-labs/core-ai/helius-data-queries)
Your own site
<a href="https://agentmods.dev/rules/helius-labs/core-ai/helius-data-queries"><img src="https://agentmods.dev/badge/rules/helius-labs/core-ai/helius-data-queries.svg" alt="Measured on agentmods" height="20"></a>
Per session 0 Nothing until a file matches its globs; then the whole rule loads.
When invoked 433 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00000 $0.00433
Opus 5 $0.00000 $0.00217
Sonnet 5 $0.00000 $0.00087
Haiku 4.5 $0.00000 $0.00043

Measured 5d ago against content hash 82e249f695d2, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

helius-data-queries scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

helius-cursor/rules/helius-data-queries.mdc · 29 lines

What it actually says

DAS API

  • Use getAssetsByOwner with showFungible: true to get both NFTs and fungible tokens in one call
  • Use searchAssets for multi-criteria queries instead of client-side filtering
  • Use batch endpoints (getAsset with ids array, getAssetProofBatch) instead of sequential single calls

Transaction History

  • Prefer parseTransactions over raw RPC for transaction history — it returns human-readable data
  • Use getTransactionHistory in signatures mode for lightweight listing, then parseTransactions only on transactions of interest
  • SDK parameter names differ from API names — the REST API uses kebab-case (before-signature), the Enhanced SDK uses camelCase (beforeSignature), and the RPC SDK uses different names entirely (paginationToken). Always check the enhanced-transactions reference before writing pagination or filtering code
  • Never use any for SDK request params — import the proper request types (GetEnhancedTransactionsByAddressRequest, GetTransactionsForAddressConfigFull, etc.) so TypeScript catches name mismatches at compile time; a wrong param name like before instead of beforeSignature silently does nothing
  • helius.enhanced.getTransactionsByAddress() and helius.getTransactionsForAddress() have completely different parameter shapes and pagination mechanisms — do not mix them

Token & Balance Queries

  • Prefer getBalance (returns ~2 lines) over getWalletBalances (returns 50+ lines) when only SOL balance is needed
  • Prefer getTokenBalances (compact) over getWalletBalances (full portfolio with metadata) when you don't need USD values

Documentation Lookups

  • Use lookupHeliusDocs with the section parameter for targeted lookups — full docs can be 10,000+ tokens; a targeted section is typically 500-2,000 tokens
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 29 lines · 0 tokens per session scan A 82e249f695d2

Subscribe to this mod's changes

helius-data-queries is a cursor rule published in the GitHub repository helius-labs/core-ai (26 stars, last pushed yesterday), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 433 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other cursor rules, from other repositories

flow-configuration

Comprehensive guide to Flow project configuration covering flow.json structure, CLI workflow, FCL integration, network management, and deployment best practices. Covers contract aliases, account management, dependency resolution, frontend FCL setup with React SDK, and environment-based configuration for seamless…

onflow/cadence-rules · 55 tokens

cadence-nft-standards

Comprehensive standards and best practices for developing Non-Fungible Tokens (NFTs) using Cadence. Ensures proper implementation of NonFungibleToken interfaces, MetadataViews integration for marketplace compatibility, secure resource handling patterns, and advanced modular architectures for complex NFTs with traits…

onflow/cadence-rules · 81 tokens

flow-development-workflow

Streamlined Flow development workflow covering documentation-first debugging methodology, iterative development approach, deployment verification, gas optimization strategies, and comprehensive testnet validation protocols. Focuses on practical workflows and error prevention rather than configuration details.

onflow/cadence-rules · 42 tokens

user-preferences

Defines personalized development preferences and communication style for Flow blockchain development including concise response formatting, documentation-driven problem solving, iterative workflow methodology, full-stack awareness, and systematic error resolution. Guides AI behavior to match user's preferred…

onflow/cadence-rules · 1,796 tokens

ai-generation-entrypoint

Start here — Happy Path (Restake): workflows/restaking-workflow.md.

onflow/cadence-rules · 1,748 tokens

client-workflow-bootstrap

Cursor rule "client-workflow-bootstrap" from ulises-jeremias/agent-toolkit, covering agent vs skill rule — why agent (cite clause), when to use vs holistic, caller / skills / handoff, interview process and gate before generating.

ulises-jeremias/agent-toolkit · 1,353 tokens