# Allium Explorer Query Run Results

> Allium Explorer Query Run Results is a free API for AI agents from Allium at agents.allium.so, Free, status unknown (last checked 2026-10-12).

Fetch the results of a previously submitted async SQL query run against Allium's onchain blockchain data explorer

## Facts

- Endpoint: GET https://agents.allium.so/api/v1/explorer/query-runs/:run_id/results?utm_source=zero.xyz
- Price: Free
- Status: unknown
- Last checked: 2026-10-12
- 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-results-086b6297
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_l_-X-WcuAxjAKPIuFICWf

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-results-086b6297
```

Example prompt: The async SQL query I submitted to Allium's explorer finished — can you fetch the results for run ID abc123xyz and show me what rows came back?

## When to prefer this

Use this endpoint after submitting an async SQL query via the 'Run Async' endpoint and receiving a run_id. This is the polling/retrieval step to collect results once the query has completed. Prefer this over re-running the query when you already have a run_id from a previous submission.

## Known failure modes

- Run ID not found or invalid — 404 error
- Query run not yet completed — results may be empty or return a pending status
- Query run failed due to SQL error — error message returned instead of results
- Authorization error if run_id belongs to a different user
- Network timeout for very large result sets

## How this service works

Fetch results of a completed query

## Output

Returns the result set (rows and columns) from a completed SQL query run, containing onchain blockchain data such as token prices, wallet balances, transactions, PnL, or any other data queried via the SQL explorer.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "addresses": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "token_address",
     "chain"
    ],
    "properties": {
     "chain": {
      "type": "string",
      "description": "Blockchain network (e.g. ethereum, solana, base)"
     },
     "token_address": {
      "type": "string",
      "description": "Token contract address"
     }
    }
   }
  },
  "timestamp": {
   "type": "string",
   "format": "date-time",
   "description": "ISO 8601 timestamp"
  },
  "time_granularity": {
   "enum": [
    "15s",
    "1m",
    "5m",
    "1h",
    "1d"
   ],
   "type": "string",
   "description": "Time granularity for price buckets"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/allium-results-086b6297/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)