# aiworker-data: Base Trending Tokens

> aiworker-data: Base Trending Tokens is a paid API for AI agents from aiworker.duckdns.org, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns GeckoTerminal's current trending token pools on Base with price, volume, liquidity, buy/sell counts, and price change percentages, filtered for meaningful pools.

## Facts

- Endpoint: GET https://aiworker.duckdns.org/v1/market/trending
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aiworker-data-base-trending-tokens-c6af8bb8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tZpbgMzIS0pUjWEfQFZrA

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 aiworker-data-base-trending-tokens-c6af8bb8
```

Example prompt: What tokens are trending on Base right now? Show me the top 10 pools with price, 24h volume, liquidity, and how much the price has moved in the last hour and 24 hours — exclude anything with low liquidity.

## When to prefer this

Use this endpoint when you need a real-time, deterministic snapshot of which token pools on Base are currently trending according to GeckoTerminal's ranking, complete with market metrics. Prefer this over general token search endpoints when the user's intent is to discover momentum or hot tokens rather than look up a specific known token. The liquidity and stablecoin filters make results more actionable than raw GeckoTerminal output.

## Known failure modes

- GeckoTerminal API unavailable — upstream data source error returned
- Fewer than requested pools returned if trending list is short or liquidity filter is aggressive
- Stale data up to 5 minutes old due to caching
- Pools with WETH or stablecoin bases are always excluded regardless of parameters
- Payment failure via x402 if USDC balance is insufficient

## How this service works

Trending tokens on Base right now: the pools GeckoTerminal ranks as trending, with price, 24 h volume, liquidity, 1 h/6 h/24 h price change, buys and sells, and pool age — stablecoin and WETH bases excluded, pools under a liquidity floor excluded (default $10,000). Deterministic, no LLM, no ranking of ours; cached five minutes.

## Output

A JSON object with a timestamp, the Base chain identifier, and an array of up to 20 trending pool objects each containing DEX name, pool and token address, token name/symbol, price in USD, 24h volume, liquidity, 1h/6h/24h price change percentages, and 24h buy/sell transaction counts. Includes attribution to GeckoTerminal, a disclaimer that this is informational only, and a list of data sources used. Cached for 5 minutes.

## 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": {
      "limit": {
       "type": "integer",
       "default": 10,
       "maximum": 20,
       "minimum": 1
      },
      "min_liquidity_usd": {
       "type": "number",
       "default": 10000,
       "minimum": 0
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "as_of": {
       "type": "string"
      },
      "chain": {
       "type": "string"
      },
      "pools": {
       "type": "array",
       "items": {
        "type": "object"
       }
      },
      "sources": {
       "type": "array"
      },
      "disclaimer": {
       "type": "string"
      },
      "attribution": {
       "type": "string"
      },
      "generated_at": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-09-13T00:00:00.000Z",
  "chain": "eip155:8453",
  "pools": [
   {
    "dex": "aerodrome-base",
    "pool": "0x99cf3e8bfb02c300312c53aac5d0b082e3d5975c",
    "token": {
     "name": "LAPTOP",
     "symbol": "LAPTOP",
     "address": "0x99cf3e8bfb02c300312c53aac5d0b082e3d5975c"
    },
    "txns_24h": {
     "buys": 1210,
     "sells": 980
    },
    "price_usd": 0.3648,
    "liquidity_usd": 1645781.79,
    "volume_24h_usd": 1510950.65,
    "pool_created_at": "2026-09-09T02:27:33Z",
    "price_change_pct": {
     "h1": 2.1,
     "h6": 8.4,
     "h24": 41.2
    }
   }
  ],
  "sources": [
   {
    "ok": true,
    "url": "https://api.geckoterminal.com/api/v2/networks/base/trending_pools",
    "name": "geckoterminal_trending"
   }
  ],
  "disclaimer": "Informational only; not investment advice. Trending is GeckoTerminal's order, not a recommendation.",
  "attribution": "Data: GeckoTerminal (trending pools, Base)",
  "generated_at": "2026-09-13T00:00:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aiworker-data-base-trending-tokens-c6af8bb8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from aiworker.duckdns.org](https://www.zero.xyz/host/aiworker.duckdns.org/llms.txt)