# BaseScout Safe Token Feed

> BaseScout Safe Token Feed is a paid API for AI agents from basescout-feed-x402.baseagentx402.workers.dev, paid per call via x402, $0.2/call, status unknown (last checked 2026-09-15).

Returns pre-filtered, basesafe-vetted ERC-20 token candidates recently launched on Aerodrome (Base chain), ranked by safety score and liquidity.

## Facts

- Endpoint: GET https://basescout-feed-x402.baseagentx402.workers.dev/safe-tokens
- Price: $0.2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/basescout-safe-token-feed-b22a6404
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LOcSMxJsNIXHGkaj45kg6

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 basescout-safe-token-feed-b22a6404
```

Example prompt: Pull me the latest safe token candidates from Aerodrome on Base — show up to 8 pools, only tokens with a basesafe score of at least 70, recommendations of OK or CAUTION only, and a minimum liquidity of $5000.

## When to prefer this

Use this endpoint when you need a ready-to-use, pre-filtered list of freshly launched Base ERC-20 tokens without building your own discovery and safety-vetting pipeline. It is ideal for trading bots or agents that want to act on new Aerodrome listings quickly while delegating safety scoring (basesafe) and liquidity filtering to the service. Prefer this over manual on-chain scanning when you want both token discovery and safety vetting in a single paid call.

## Known failure modes

- Invalid min_score value (non-numeric string) — likely returns 400 or falls back to default
- count exceeds max of 10 — capped or rejected
- min_liquidity_usd too high — returns empty tokens array with valid metadata
- basesafe upstream vetting service unavailable — may return 503 or partial results
- Payment not completed via x402 — returns 402 Payment Required before serving data
- No new Aerodrome pools matching filters — returns empty tokens array

## How this service works

Returns the most recent Base ERC-20s opened on Aerodrome that pass a basesafe safety check. Buyers specify min score, allowed recommendations, and a local liquidity floor. basescout pays basesafe under the hood and absorbs the vetting cost into the response price. Built for trading bots and agents that need fresh, pre-filtered token candidates without running their own discovery + vetting pipeline.

## Output

A JSON object containing an array of recently launched ERC-20 tokens on Aerodrome that passed the basesafe vetting pipeline, each with token address, symbol, safety score, recommendation label (OK/CAUTION/AVOID/UNKNOWN), liquidity in USD, pool address, risk flags, and vetting timestamp — plus summary stats (total pools scanned, tokens considered after local filter, tokens returned, generation timestamp).

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "count": "5",
   "min_score": "60",
   "recommendation": "OK,CAUTION",
   "min_liquidity_usd": "1000"
  }
 }
}
```

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "count": {
       "type": "string",
       "description": "How many liquidity-passing tokens to return (default 5, max 10). basescout walks back through Aerodrome pools until it finds this many, capped at 30 pools scanned."
      },
      "min_score": {
       "type": "string",
       "description": "basesafe score threshold (default 60)"
      },
      "recommendation": {
       "type": "string",
       "description": "Comma-separated whitelist (default 'OK,CAUTION')"
      },
      "min_liquidity_usd": {
       "type": "string",
       "description": "Local pre-filter: skip pools below this USD depth (default 1000)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "tokens",
      "generatedAt"
     ],
     "properties": {
      "tokens": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "flags": {
          "type": "array",
          "items": {
           "type": "string"
          }
         },
         "score": {
          "type": "number"
         },
         "symbol": {
          "type": "string"
         },
         "address": {
          "type": "string"
         },
         "vetted_at": {
          "type": "string"
         },
         "pool_address": {
          "type": "string"
         },
         "liquidity_usd": {
          "type": "number"
         },
         "recommendation": {
          "enum": [
           "OK",
           "CAUTION",
           "AVOID",
           "UNKNOWN"
          ],
          "type": "string"
         }
        }
       }
      },
      "generatedAt": {
       "type": "string"
      },
      "poolsScanned": {
       "type": "number"
      },
      "tokensReturned": {
       "type": "number"
      },
      "scanBudgetExhausted": {
       "type": "boolean"
      },
      "candidatesAfterLocalFilter": {
       "type": "numbe
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/basescout-safe-token-feed-b22a6404/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from basescout-feed-x402.baseagentx402.workers.dev](https://www.zero.xyz/host/basescout-feed-x402.baseagentx402.workers.dev/llms.txt)