# VIBE Top Perps — Single Symbol Conviction Card

> VIBE Top Perps — Single Symbol Conviction Card is a paid API for AI agents from api.vibe.airforce, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-11).

Returns a 6-dimension AI-scored conviction card for a single perpetuals token symbol, including smart money flow data, rank within its cohort, and a one-sentence thesis, refreshed every 30 minutes.

## Facts

- Endpoint: GET https://api.vibe.airforce/api/x402/alpha/top-perps/%7Bsymbol%7D
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vibe-top-perps-single-symbol-conviction-card-4e2edaed
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OVkSe0bjfVf9aWbeOP3Hs

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 vibe-top-perps-single-symbol-conviction-card-4e2edaed
```

Example prompt: What's the current VIBE smart money conviction card for ETH perps — give me the score breakdown, the thesis, and where it ranks in its cohort?

## When to prefer this

Use this endpoint when you need a detailed, AI-scored conviction profile for a specific perpetuals token — including multi-dimension breakdown, smart money flow stats, and cohort ranking — rather than a simple price feed or a broad list of top picks. It is ideal when an agent needs to justify or contextualize a trade decision with smart money signal for one specific symbol. Prefer this over the full radar list endpoint when you already know the symbol you care about and want rich per-token detail with cohort context.

## Known failure modes

- Symbol not found in radar: found=false returned with empty card, meaning the token is not currently a scored top perp pick
- Invalid or misspelled symbol: may return found=false or a 400-level error
- x402 payment failure: insufficient USDC balance or unsupported wallet prevents the $0.05 payment and blocks the response
- Stale data: radar refreshes every 30 min so scores may be up to 30 minutes old
- Network or upstream outage: success=false returned with no card data

## How this service works

Top Picks: AI-verified smart money tokens every 30 min. 6-dimension scores, one-sentence thesis, smart money flow data. Plus 50+ crypto-data endpoints via x402 USDC on Base. No API keys, no accounts.

## Output

Returns a scored card object for the requested symbol containing: token_symbol, trade side (long/short), cohort rank, conviction score, 6 dimension sub-scores, a one-sentence narration/thesis, and live stats (net_usd smart money flow, wallet count, funding rate, mark price, 1h/6h/24h price deltas). Also includes a 'found' boolean indicating whether the symbol was in the active radar, conviction context (cohort size and average cohort conviction), response metadata (updated_at, source, price_usdc), and x402 payment details (tx_hash, amount_paid, buyer_address, payment_mode).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "body": {
     "type": "object",
     "properties": {}
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "data": {
     "type": "object",
     "properties": {
      "data": {
       "type": "object",
       "properties": {
        "card": {
         "type": "object",
         "description": "Full scored card: token_symbol, side, rank, conviction, dimensions, narration, stats (net_usd, wallets, funding, mark_price, delta_1h/6h/24h)"
        },
        "found": {
         "type": "boolean",
         "description": "Whether the symbol was in the scored radar"
        },
        "context": {
         "type": "object",
         "description": "Conviction context: side, cohort_rank, cohort_size, cohort_avg_conviction"
        }
       },
       "description": "Card payload"
      },
      "meta": {
       "type": "object",
       "description": "Response metadata: updated_at, source, price_usdc"
      },
      "success": {
       "type": "boolean",
       "description": "True when the radar was served"
      },
      "tx_hash": {
       "type": "string",
       "description": "EIP-3009 payment transaction hash on Base"
      },
      "amount_paid": {
       "type": "number",
       "description": "Amount paid for this request in USDC"
      },
      "payment_mode": {
       "enum": [
        "x402",
        "credit"
       ],
       "type": "string",
       "description": "How this request was paid: x402 (on-chain) or credit (API key)"
      },
      "buyer_address": {
       "type": "string",
       "description": "Ethereum address that paid for this request"
      }
     },
     "description": "Single scored Top Perps card for one symbol with conviction context — full card plus cohort rank/size and average cohort conviction"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "description": "Single scored Top Perps card for one symbol with conviction context — full card plus cohort rank/size and average cohort conviction"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vibe-top-perps-single-symbol-conviction-card-4e2edaed/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vibe.airforce](https://www.zero.xyz/host/api.vibe.airforce/llms.txt)