# TradeOS Token Discovery Feed

> TradeOS Token Discovery Feed is a paid API for AI agents from tradeos.tech, paid per call via x402, $0.25/call, status unknown (last checked 2026-09-14).

Returns up to 25 current signal candidates for token scanning and watchlist population, with reasons, freshness, and safety metadata.

## Facts

- Endpoint: POST https://tradeos.tech/x402/v1/intelligence/tradeos-token-discovery
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tradeos-tech-4ba6af51
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_f3lMcQRp-2TtdNgbt3QC6

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 tradeos-tech-4ba6af51 -d '<json body>'
```

Example prompt: Pull me a fresh batch of up to 25 token discovery candidates from TradeOS right now — I want the signal reasons and freshness metadata so I can decide what to add to my watchlist.

## When to prefer this

Use this endpoint when you need a ready-made batch of signal candidates for a watchlist or screener without building your own raw feed ingestion pipeline. Prefer this over the full intelligence bundle when you only need discovery candidates, not regime, VPIN, or forecast data. Ideal for agents populating dashboards or bots that need a periodic refresh of candidate tokens.

## Known failure modes

- Payment not processed — returns 402 if USDC payment is missing or insufficient
- Invalid filter parameters — returns 400 with validation errors if criteria are malformed
- No candidates found — returns empty candidate list if no tokens meet the specified criteria
- Rate limit exceeded — returns 429 if call volume exceeds plan limits
- Stale data warning — freshness field may indicate candidates are older than expected if market data pipeline lags

## Output

A JSON response containing up to 25 current token signal candidates, each with discovery reasons, signal scores, freshness indicators, and safety/risk boundaries. Read-only research output — no trade instructions or execution.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "properties": {
      "output": {
       "type": "string"
      },
      "symbol": {
       "type": "string"
      },
      "chain_id": {
       "type": "string"
      },
      "metadata": {
       "type": "object"
      },
      "contract_address": {
       "type": "string"
      }
     },
     "additionalProperties": true
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "const": "POST"
    },
    "bodyType": {
     "type": "string",
     "const": "json"
    }
   }
  },
  "output": {
   "type": "object"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tradeos-tech-4ba6af51/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tradeos.tech](https://www.zero.xyz/host/tradeos.tech/llms.txt)