{"uid":"cap_FyZJHkINFyMnppq9w5hS4","slug":"allium-run-async-aba31ada","name":"Allium Explorer - Run Saved Query Async","description":"Run a saved query asynchronously","url":"https://agents.allium.so/api/v1/explorer/queries/:query_id/run-async?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"addresses":{"type":"array","items":{"type":"object","required":["chain","address"],"properties":{"chain":{"type":"string","description":"Blockchain network (e.g. ethereum, solana, base)"},"address":{"type":"string","description":"Wallet address"}}}},"end_timestamp":{"type":"string","format":"date-time","description":"ISO 8601 timestamp"},"start_timestamp":{"type":"string","format":"date-time","description":"ISO 8601 timestamp"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["blockchain","prices","tokens","wallet","balances","transactions","pnl","sql","explorer","solana","base","defi","data"],"displayCostAmount":"0.020000","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.020000/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_pFor5CCIvKhBym7sb1RUJ","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"Allium","brandSlug":"allium","brandBaseUrl":"https://allium.so","brandDocsUrl":"https://docs.allium.so","whatItDoes":"Asynchronously executes a pre-saved SQL query on Allium's blockchain data explorer, optionally parameterized with wallet addresses and time ranges","exampleAgentPrompt":"Run my saved Allium explorer query (query ID abc123) asynchronously for wallet address 0xABCDEF1234567890 on Ethereum, looking at data between January 1, 2024 and March 31, 2024.","exampleUseCases":null,"resultDescription":"Returns a job or run identifier that can be used to poll the async query's status and eventually retrieve results from the blockchain data explorer once execution completes.","failureModes":["Invalid or non-existent query_id returns 404 not found","Malformed wallet address or unsupported chain returns 400 validation error","Invalid ISO 8601 timestamp format returns 400 bad request","Insufficient funds or missing payment returns 402 payment required","Query execution timeout or resource limit exceeded returns 500 or job failure status","Rate limiting on concurrent async jobs returns 429"],"whenToPreferThis":"Use this endpoint when you have a pre-built, saved SQL query in Allium Explorer and want to run it asynchronously — especially for long-running or complex queries over large blockchain datasets. Prefer this over the raw SQL async endpoint when your query logic is already saved and you only need to supply dynamic parameters like addresses and time ranges. Pair with the Status endpoint to poll for completion.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:31:40.940Z","isFirstParty":false,"canonicalSlug":"allium-run-async-aba31ada"}