NarTools Documentation

Welcome to NarTools - a real-time blockchain intelligence platform providing cross-chain analytics and insights.

Quick Start

Get up and running with NarTools in minutes:

Key Features

Cross-Chain Analytics

NarTools monitors transactions across multiple blockchain networks including Ethereum, Polygon, Base, Solana, Bitcoin, and Avalanche. View comparative metrics, gas fees, and transaction volumes in real-time.

NQL Query Engine

NarTools Query Language (NQL) allows you to query blockchain data using familiar SQL syntax. Run complex analytical queries without needing to run your own blockchain nodes.

Real-Time Data

Our fetchers continuously collect and index blockchain transactions, providing up-to-the-minute insights into network activity.

What is NQL?

NQL (NarTools Query Language) is a SQL-based query interface for blockchain data. It provides a familiar and powerful way to analyze transaction data without writing complex blockchain queries.

Query Syntax

NQL uses standard SQL syntax with access to the transactions table.

Available Columns

• chain - Blockchain name (ethereum, polygon, base, etc.)
• hash - Transaction hash
• timestamp - Transaction timestamp
• gas_price - Gas price in Gwei
• gas_used - Gas units used
• fee_eth - Fee in native currency
• fee_usd - Fee in USD
• block_number - Block number

Example Queries

Transaction Count by Chain

SELECT chain, COUNT(*) as tx_count
FROM transactions
WHERE timestamp > datetime('now', '-7 days')
GROUP BY chain
ORDER BY tx_count DESC

Average Gas Fees

SELECT
    chain,
    ROUND(AVG(fee_usd), 4) as avg_fee_usd,
    ROUND(AVG(gas_price), 2) as avg_gas_gwei
FROM transactions
WHERE timestamp > datetime('now', '-24 hours')
GROUP BY chain
ORDER BY avg_fee_usd DESC

High Value Transactions

SELECT chain, hash, fee_usd, timestamp
FROM transactions
WHERE fee_usd > 10
ORDER BY fee_usd DESC
LIMIT 20

NQL Roadmap

We're continuously improving NQL to make it the best tool for cross-chain transaction analysis. Here's what's coming next:

Phase 1: Enhanced Query Experience (Q1 2025)

• Syntax Highlighting - Monaco Editor integration with SQL autocomplete and code formatting
• Query History - Track and replay your previous queries with execution timestamps
• Saved Queries - Bookmark frequently used queries for quick access
• Query Parameters - Create dynamic queries with variables (e.g., WHERE chain = )

Phase 2: Visualizations (Q2 2025)

• Auto-Visualization - Automatic chart generation from query results (bar, line, pie charts)
• Custom Charts - Build custom visualizations with Chart.js integration
• Metric Counters - Display key metrics as large counters (total fees, avg gas, etc.)
• Interactive Tables - Sortable, filterable result tables with export options

Phase 3: Collaboration & Sharing (Q2 2025)

• Query Sharing - Generate shareable links to queries and results
• Dashboards - Combine multiple queries and charts into unified dashboards
• Query Forking - Copy and modify shared queries from other users
• Team Workspaces - Collaborate with team members on query collections

Phase 4: Advanced Features (Q3 2025)

• Query Scheduler - Run queries automatically on hourly/daily schedules
• Alerts & Notifications - Get notified when query results meet specific conditions
• Materialized Views - Cache expensive queries for instant results
• Query Performance Insights - Execution plans and optimization suggestions

Phase 5: AI & Intelligence (Q4 2025)

• NQL AI Assistant - Natural language to SQL query generation
• Smart Suggestions - AI-powered query recommendations based on your data
• Anomaly Detection - Automatic alerts for unusual transaction patterns
• Trend Analysis - AI-generated insights from your query results

Future Enhancements

• Multi-Table Support - Query across blocks, smart contracts, and wallet data
• Cross-Chain Joins - Correlate data across different blockchain networks
• Custom Data Sources - Import and query your own off-chain data
• Blockchain-Specific Functions - Built-in functions for address formatting, hash conversions, wei calculations
• API Integration - Execute NQL queries programmatically via REST API
• Embedded Analytics - Embed NQL queries and charts in external applications

Supported Chains

Ethereum

The largest smart contract platform. NarTools tracks Ethereum mainnet transactions including gas fees, block times, and network activity.

Polygon

A layer-2 scaling solution for Ethereum. Monitor low-cost transactions and high throughput activity on Polygon PoS.

Base

Coinbase's Ethereum L2 built on OP Stack. Track transactions on this rapidly growing ecosystem.

Solana

High-performance blockchain with sub-second finality. Monitor Solana's unique transaction patterns and fees.

Bitcoin

The original cryptocurrency network. Track Bitcoin transactions, fees, and block metrics.

Avalanche

Fast, low-cost EVM-compatible blockchain. Analyze Avalanche C-Chain activity.

API Overview

NarTools provides a RESTful API for programmatic access to blockchain data.

Base URL

https://nartools.com/api

API Endpoints

Get Transaction Data

GET /api/data?chain={chain_name}

Returns recent transaction metrics for the specified chain.

Get Transactions

GET /api/transactions?chain={chain_name}&page={page}&limit={limit}

Returns paginated transaction list.

Execute NQL Query

POST /api/nql/execute
Content-Type: application/json

{
  "query": "SELECT * FROM transactions LIMIT 10"
}

Code Examples

Python

import requests

# Get Ethereum data
response = requests.get('https://nartools.com/api/data?chain=ethereum')
data = response.json()
print(data)

JavaScript

// Fetch transactions
const response = await fetch('/api/transactions?chain=polygon&limit=20');
const data = await response.json();
console.log(data.transactions);

cURL

curl -X POST https://nartools.com/api/nql/execute \
  -H "Content-Type: application/json" \
  -d '{"query":"SELECT chain, COUNT(*) FROM transactions GROUP BY chain"}'