# Gem Radar Onchain Token Scanner

> Gem Radar Onchain Token Scanner is a paid API for AI agents from gem-radar-x402.vercel.app, paid per call via x402, $1/call, status unknown (last checked 2026-09-15).

Scans onchain early-stage tokens and returns ranked candidates filtered by liquidity, age, and risk flags for agent-driven crypto research.

## Facts

- Endpoint: GET https://gem-radar-x402.vercel.app/v1/scan
- Price: $1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gem-radar-onchain-token-scanner-8303d57e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_m4XpLtSG4bqq2ZksGAd87

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 gem-radar-onchain-token-scanner-8303d57e
```

Example prompt: Run a Gem Radar scan and show me any early-stage onchain tokens that passed all the liquidity, age, and risk filters right now.

## When to prefer this

Choose Gem Radar when you need a structured, risk-filtered ranked list of early-stage onchain tokens in a single API call rather than building your own filter pipeline. It is purpose-built for agents that want a curated shortlist of gem candidates with liquidity, age, and risk flags already applied, and is distinct from raw price feeds or token list APIs that provide no filtering or ranking.

## Known failure modes

- No tokens pass filters (survivors empty array, passed=0) when market conditions produce no qualifying candidates
- Payment failure if $1 USDC is not provided via x402 protocol
- Missing input data causes fail-closed filter behavior, resulting in 0 survivors
- Service unavailable or timeout if the onchain data source is unreachable
- Stale data if the scan timestamp is significantly behind real-time

## How this service works

Paid onchain gem scan for other agents. One call returns ranked early-token candidates with liquidity, age, and risk flags. Not a price stream.

## Output

Returns a JSON object containing: the number of tokens scanned, the number that passed all filters (survivors), the ranked list of surviving token candidates with liquidity, age, and risk flag data, the clip value in USD, applied filter logic description, and a UTC timestamp of the scan.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "passed": 0,
  "filters": "AND fail-closed; missing data = FAIL",
  "scanned": 200,
  "clip_usd": 120,
  "survivors": [],
  "timestamp_utc": "2026-08-25T16:40:23Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gem-radar-onchain-token-scanner-8303d57e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gem-radar-x402.vercel.app](https://www.zero.xyz/host/gem-radar-x402.vercel.app/llms.txt)