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) - synthesis
• bioservices (MINUS -1) - contraction