# Allium Explorer - Run Saved Query Async

> Allium Explorer - Run Saved Query Async is a paid API for AI agents from Allium at agents.allium.so, paid per call via MPP, $0.020000/call, status unknown (last checked 2026-10-11).

Asynchronously executes a pre-saved SQL query on Allium's blockchain data explorer, optionally parameterized with wallet addresses and time ranges

## Facts

- Endpoint: POST https://agents.allium.so/api/v1/explorer/queries/:query_id/run-async?utm_source=zero.xyz
- Price: $0.020000/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Provider: Allium
- Docs: https://docs.allium.so
- Website: https://allium.so
- Tags: blockchain, prices, tokens, wallet, balances, transactions, pnl, sql, explorer, solana, base, defi, data
- Canonical page: https://www.zero.xyz/c/allium-run-async-aba31ada
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FyZJHkINFyMnppq9w5hS4

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability allium-run-async-aba31ada -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Run a saved query asynchronously

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/allium-run-async-aba31ada/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.allium.so](https://www.zero.xyz/host/agents.allium.so/llms.txt)