Using Natural Language Search to Query Stellar Blockchain Data

Querying blockchain data usually means learning API endpoints, understanding parameters, parsing JSON responses, and handling pagination. What if you could just type "top 10 XLM holders" and get a table of results?

That is what LumenQuery's natural language query does. It translates plain English questions into Horizon API calls and returns formatted results.

How It Works

You type a question in plain English

The parser identifies the query type and parameters

The executor runs the appropriate Horizon API calls

Results are returned in a formatted table

No SDK knowledge required. No API documentation to read. Just ask a question.

Supported Queries

Account Queries

"Show account GAAZI4TCR3TY5OJHCTJC2A4QSY6CJWJH5IAJTGKIN2ER7LBNVKOCCWN7"

Returns: Account ID, balances, signers, thresholds, home domain.

"Top 10 XLM holders"

Returns: Largest XLM balances on the network with account IDs and amounts.

Payment Queries

"Recent payments"

Returns: Latest payment operations with amounts, assets, senders, and recipients.

"Payments larger than 100,000 XLM"

Returns: Whale movements — payments exceeding your specified threshold.

Transaction Queries

"Latest 50 transactions"

Returns: Recent transactions with hashes, ledger numbers, operation counts, and fees.

"Transactions for GABC..."

Returns: Transaction history for a specific account.

Network Queries

"Latest ledger status"

Returns: Current ledger sequence, close time, transaction count, protocol version, and base fee.

Asset Queries

"What assets are on Stellar?"

Returns: Popular Stellar assets with codes, issuers, and holder counts.

Try It Now

Go to lumenquery.io/query and try these examples:

Query	What You Get
"Top 10 XLM holders"	Largest wallets by balance
"Recent payments"	Latest payment activity
"Payments larger than 1M XLM"	Whale transfers
"What assets are on Stellar?"	Token listing
"Latest ledger status"	Network health snapshot
"Latest 50 transactions"	Recent transaction feed

Each query runs against the live Stellar network and returns real-time data.

What You See

For each query, the interface shows:

Results table — Formatted data with sortable columns

SQL preview — The equivalent SQL representation for learning

Execution time — How long the query took

Query type — What the parser detected (top_holders, recent_payments, etc.)

Under the Hood

The query system uses a rule-based parser that matches natural language patterns to query types:

"top N" + "holders" → top_holders query

"payments" + "larger than" + amount → large_payments query

"account" + Stellar address → account_info query

"ledger" or "network status" → ledger_info query

The executor then translates each query type into the appropriate Horizon API calls, fetches the data, and formats the response.

Who This Is For

Non-Technical Users

Product managers, analysts, and business users who need blockchain data without learning APIs. Type a question, get an answer.

Developers Exploring

Developers new to Stellar who want to understand what data is available before writing code. Use natural language to explore, then switch to the API when you are ready to build.

Quick Checks

Even experienced developers use natural language queries for quick checks — "is this account funded?", "what's the latest ledger?", "show me recent whale movements."

API Access

The query endpoint is also available programmatically:

curl -X POST https://lumenquery.io/api/query \
  -H "Content-Type: application/json" \
  -d '{"query": "top 10 xlm holders"}'

Response includes the parsed query type, formatted data, column definitions, and execution time.

Try It

Head to lumenquery.io/query and start asking questions. No account required for basic queries.

*Query the Stellar blockchain in plain English. LumenQuery makes blockchain data accessible to everyone — try it now, no signup needed.*