zerø

Docs

Search Bar & Intents Classifier

Zero's search bar is powered by an intelligent Intents Classifier that automatically determines what you're looking for and routes your query to the appropriate service.

What is the Intents Classifier?

The Intents Classifier is Zero's smart search system that analyzes your query and automatically determines whether you want:

  • A web search across the internet
  • Token price information and charts
  • NEAR wallet or portfolio data
  • Transaction details
  • An AI conversation
  • NEAR Protocol knowledge
  • Trending tokens and market data

Instead of navigating menus or selecting categories, simply type your query naturally and Zero figures out what you need.

How Intent Classification Works

Zero's classifier uses pattern matching, keyword recognition, and address detection to identify your intent:

Pattern Matching

The system recognizes common query patterns like "price of BTC" or "balance of wallet.near" and routes them appropriately.

Address Detection

Zero automatically detects blockchain addresses:

  • NEAR Addresses: Accounts ending in .near or 64-character hex addresses
  • EVM Addresses: 0x-prefixed 40-character hex addresses
  • Solana Addresses: Base58-encoded 32-44 character addresses

Keyword Recognition

Specific keywords trigger different intents. For example, "swap", "buy", or "exchange" trigger swap functionality, while "explain" or "help me" trigger AI conversations.

Supported Query Types

1. Web Search

General information queries about any topic.

Example Queries:
  • "What is Bitcoin halving?"
  • "Latest crypto news"
  • "Ethereum merge explained"

2. Token Price

Get real-time price data and charts for any cryptocurrency.

Example Queries:
  • "BTC price"
  • "What is ETH at?"
  • "Chart of SOL"
  • "Price of NEAR"

3. Wallet Lookup

View portfolio, holdings, and assets for any NEAR wallet.

Example Queries:
  • "Balance of alice.near"
  • "Portfolio of bob.near"
  • "Holdings of [64-char-hex-address]"

4. Transaction Lookup

Get detailed information about NEAR transactions.

Example Queries:
  • Paste a NEAR transaction hash
  • "Transaction [tx-hash]"

5. AI Conversation

Ask questions, get explanations, or have general conversations.

Example Queries:
  • "Explain NEAR sharding to me"
  • "Can you help me understand DeFi?"
  • "Write me a summary of Aave protocol"

6. Trending Tokens

See which tokens are currently trending or have high social activity.

Example Queries:
  • "Show me trending"
  • "What's hot in crypto?"
  • "Trending tokens"

7. NEAR Knowledge

Access in-depth information about NEAR Protocol using NEAR Expert Mode.

Example Queries:
  • "How does Aurora work?"
  • "What is Pagoda?"
  • "Explain NEAR access keys"
  • "What are NEAR validators?"

8. Swap Intent

Execute token swaps or get swap quotes.

Example Queries:
  • "Swap 10 NEAR for ETH"
  • "Exchange 1 ETH to SOL"
  • "Buy NEAR with SOL"

How to Use the Search Bar

Step 1: Type Your Query

Simply type what you're looking for in natural language. Don't worry about using specific syntax or keywords - Zero understands conversational queries.

Step 2: Press Enter

Hit Enter or click the search button. Zero's Intents Classifier will analyze your query and route it to the appropriate service.

Step 3: Review Results

Zero will display results based on your intent:

  • Web Search: List of search results with titles, snippets, and links
  • Token Price: Price card with chart, market cap, volume, and 24h change
  • Wallet Lookup: Portfolio view with token holdings, NFTs, and transaction history
  • Transaction: Detailed transaction breakdown with actions, transfers, and status
  • AI Conversation: AI response with follow-up conversation ability

Step 4: Refine or Follow Up

You can refine your search or ask follow-up questions directly in the interface. Zero maintains context for conversational searches.

Tips for Better Search Results

Be Specific When Needed

While Zero handles natural language well, being specific helps with accuracy:

  • Instead of "price", use "BTC price" or "price of Bitcoin"
  • Instead of "wallet", use "balance of alice.near"
  • Include token symbols when asking about specific cryptocurrencies

Use Full Addresses

For wallet and transaction lookups, paste the complete address or transaction hash:

text
alice.near 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb GfJhD... (full tx hash)

Combine Keywords

Combine keywords to trigger specific intents:

  • "NEAR price chart" - Triggers price intent with chart display
  • "Explain NEAR sharding" - Triggers AI with NEAR knowledge context
  • "Trending crypto tokens" - Triggers trending view
Pro Tip: If Zero doesn't interpret your query correctly, try rephrasing it with different keywords or being more explicit about what you want.

Privacy in Search

All search queries are processed with Zero's privacy-first architecture:

  • Web searches are executed server-side across distributed search engines
  • Your IP address never reaches upstream search providers
  • No search history is stored
  • No tracking cookies or fingerprints
  • Results are stripped of tracking parameters
Zero Logs: Zero retains no logs of your search queries. There is no search history, no profile building, and nothing to subpoena.

When Intent Classification Fails

In rare cases, Zero might misinterpret your intent. If this happens:

  • Rephrase your query with clearer keywords
  • Be more explicit about what you want (e.g., "show me the price of BTC" instead of just "BTC")
  • Use specific action words like "search", "price", "balance", "swap"