# Coinlight Token Search

> Coinlight Token Search is a paid API for AI agents from coinlight-app.vercel.app, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-29).

Search for crypto tokens by name, symbol, or contract address across multiple chains and return the most liquid matching trading pairs with contract addresses.

## Facts

- Endpoint: GET https://coinlight-app.vercel.app/p/token-search?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/coinlight-token-search-6019cba8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xuPT-Hd0aiAQDE5lxV22q

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 coinlight-token-search-6019cba8
```

Example prompt: Can you find the contract address for BONK on Solana? I need the mint address and the most liquid trading pairs for it.

## When to prefer this

Use this endpoint when you need to resolve a human-readable token name or ticker symbol to an on-chain contract address or mint, especially across multiple chains. It's ideal for pre-trade workflows where you need the canonical address before querying balances, safety checks, or executing a swap. Prefer this over a generic blockchain explorer when you want liquidity-ranked results to disambiguate between multiple tokens sharing the same ticker.

## Known failure modes

- Token not found — returns empty results for obscure or misspelled names
- Ambiguous query returning many low-quality matches — agent must pick the most liquid pair
- Chain filter typo results in no results even if token exists on that chain
- Network timeout or Vercel cold-start latency on rare occasions
- Payment failure if USDC balance is insufficient for the $0.005 per-call fee

## How this service works

Coinlight charges USDC per API call with the x402 protocol on Solana and Base.

## Output

Returns a list of the most liquid token trading pairs matching the query, each including the token's contract address or mint, chain identifier, symbol, name, and liquidity metrics. Allows an AI agent to resolve an ambiguous ticker like 'BONK' to a specific on-chain address.

## 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",
     "examples": [
      {
       "q": "BONK",
       "chain": "solana"
      }
     ],
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Name, ticker or address, e.g. BONK."
      },
      "chain": {
       "type": "string",
       "description": "Optional chain filter: solana, base, ethereum..."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "endpoint": "Token search"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/coinlight-token-search-6019cba8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from coinlight-app.vercel.app](https://www.zero.xyz/host/coinlight-app.vercel.app/llms.txt)