| name | dune-analytics |
| description | Query Dune Analytics API for blockchain data, pyUSD flows, stablecoin metrics, and on-chain analytics. Use when analyzing DeFi protocols, token flows, or building dashboards. |
| version | 1.0.0 |
Dune Analytics
Query blockchain data via Dune Analytics API.
API Endpoints
# Execute query
curl -X POST "https://api.dune.com/api/v1/query/{query_id}/execute" \
-H "X-DUNE-API-KEY: $DUNE_API_KEY"
# Get results
curl "https://api.dune.com/api/v1/execution/{execution_id}/results" \
-H "X-DUNE-API-KEY: $DUNE_API_KEY"
# Get query by ID
curl "https://api.dune.com/api/v1/query/{query_id}" \
-H "X-DUNE-API-KEY: $DUNE_API_KEY"
pyUSD Queries
Configure query IDs via environment variables:
| Env Variable | Description |
|---|---|
DUNE_PYUSD_DAILY_TRANSFERS |
pyUSD daily transfers query ID |
DUNE_PYUSD_HOLDERS |
pyUSD holder distribution query ID |
DUNE_PYUSD_DEX_VOLUME |
pyUSD DEX volume by protocol query ID |
DUNE_PYUSD_BRIDGE_FLOWS |
pyUSD bridge flows query ID |
Python Client
from dune_client.client import DuneClient
from dune_client.query import QueryBase
dune = DuneClient(api_key=os.environ["DUNE_API_KEY"])
# Execute and fetch (use your actual query ID)
query_id = int(os.environ.get("DUNE_PYUSD_DAILY_TRANSFERS", 0))
query = QueryBase(query_id=query_id)
results = dune.run_query(query)
Integration with pyUSD Discovery
Connect to local discovery engine:
from pyusd_discovery_engine import PyusdDiscoveryEngine, DiscoveryMode
engine = PyusdDiscoveryEngine()
opportunities = engine.discover_opportunities(mode=DiscoveryMode.BY_ACCIDENT)
GF(3) Integration
Trit: +1 (PLUS - expanding/creating)
Home: Prof
Poly Op: ⊗
Color: #00FF00
Pairs with:
depth-search(ERGODIC 0) - synthesisbioservices(MINUS -1) - contraction