Run a saved Allium SQL query asynchronously for blockchain data across 150+ chains.
What it does
This endpoint lets an AI agent trigger the asynchronous execution of a previously saved SQL query on Allium's blockchain data platform. Allium indexes over 150 chains (EVM, Solana, Bitcoin, and more) and provides enterprise-grade data including token prices, wallet balances, transactions, and on-chain metrics. The async execution model is suited for heavier queries that may take time to complete.
The endpoint is part of Allium's AgentHub, which supports both x402 machine-to-machine payments (USDC on Base) and traditional API key authentication. The platform powers data infrastructure for teams like Phantom, Uniswap, and Coinbase. The query_id path parameter references a query previously created and saved via Allium's SQL explorer.
Note: During probing, this endpoint returned 405 Method Not Allowed on HEAD and GET requests, suggesting it likely requires a POST method. No 402 MPP challenge was captured, so the live payment flow could not be confirmed. Documentation at docs.allium.so may provide further details on request/response schemas.
Capabilities
Use cases
- —Running complex SQL queries against indexed blockchain data without blocking the caller
- —Retrieving historical token prices or wallet balances across 150+ chains
- —Automating on-chain analytics pipelines from an AI agent
- —Monitoring wallet activity and transaction history programmatically
Fit
Best for
- —AI agents needing structured blockchain data from multiple chains
- —Developers running saved analytical SQL queries against on-chain data
- —Automated pipelines that can poll for async query results
Not for
- —Real-time sub-second streaming of blockchain events (async model has latency)
- —Users without a pre-saved query_id in Allium's explorer
- —Non-blockchain data queries
Quick start
curl -X POST https://agents.allium.so/api/v1/explorer/queries/YOUR_QUERY_ID/run-async \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"Endpoint
Quality
The endpoint returned 405 on HEAD/GET (likely POST-only) and no 402 challenge was captured, so liveness via MPP is unconfirmed. No OpenAPI schema, no documentation page (404), and no example request/response are available. Most information is inferred from the landing page and Bazaar description.
Warnings
- —Endpoint did not return a 402 MPP challenge on HEAD or GET — likely requires POST method, but payment flow unconfirmed
- —No OpenAPI or schema documentation available; request/response formats are unknown
- —docs.allium.so may have details but was not crawled; agents.allium.so/docs returned 404
- —Pricing details (per-request cost) not captured in probe
Citations
- —Allium indexes 150+ chains including EVM, Solana, and Bitcoinhttps://agents.allium.so
- —AgentHub supports x402 payment in USDC on Base or traditional API key authhttps://agents.allium.so
- —Allium powers data infrastructure for Phantom, Uniswap, Coinbasehttps://agents.allium.so
- —Endpoint returned 405 on HEAD and GET probe attemptshttps://agents.allium.so/api/v1/explorer/queries/:query_id/run-async