# SLAMai Token Price

> SLAMai Token Price is a paid API for AI agents from api.slamai.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns current token prices with FDV, liquidity, and 24h price change for up to 30 tokens, quoted in USD, ETH, or BTC

## Facts

- Endpoint: POST https://api.slamai.dev/token/price
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-slamai-dev-a1bea100
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZSjzXBXfMygKzwrQSsOTF

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 api-slamai-dev-a1bea100 -d '<json body>'
```

Example prompt: What are the current prices of PEPE, WIF, and BONK quoted in USD — include their FDV, liquidity, and 24-hour price change?

## When to prefer this

Use this endpoint when you need current spot prices with FDV, liquidity, and 24h change for one or more crypto tokens, especially when you need flexible quote currency (USD, ETH, or BTC) and can identify tokens by symbol or contract address. Prefer over generic price APIs when you also need on-chain liquidity and FDV context alongside the price.

## Known failure modes

- Both 'symbols' and 'addresses' provided simultaneously — API rejects the request
- More than 30 tokens requested — exceeds max entries limit
- Invalid quote_symbol value (not USD, ETH, or BTC) — validation error
- Unknown or delisted token symbol — no price data returned
- Invalid contract address format — lookup fails
- Payment not fulfilled via x402 — 402 Payment Required response

## How this service works


Returns current token prices with FDV, liquidity, and 24h price change, quoted in **USD**, **ETH**, or **BTC**.

### Rules
- Provide **either** `symbols` or `addresses`, not both.
- Max **30 entries** for either parameter (pipe-delimited).
- `quote_symbol` must be one of: `USD`, `ETH`, `BTC`.

## Output

Returns a structured response with current price, fully diluted valuation (FDV), liquidity depth, and 24-hour price change for each requested token, denominated in the specified quote currency (USD, ETH, or BTC).

## Example request

```json
{
 "symbols": "ETH|BTC|SOL",
 "blockchain": "ethereum",
 "quote_symbol": "USD"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "blockchain"
 ],
 "properties": {
  "symbols": {
   "type": "string",
   "description": "Pipe-delimited list of token symbols to query (e.g., SWARM|VADER). Cannot be used with 'addresses'. Max 30 symbols."
  },
  "addresses": {
   "type": "string",
   "description": "Pipe-delimited list of token contract addresses (e.g., 0xabc...|0xdef...). Cannot be used with 'symbols'. Max 30 addresses."
  },
  "blockchain": {
   "type": "string",
   "description": "The blockchain network to query."
  },
  "quote_symbol": {
   "type": "string",
   "description": "Quote token or currency to return prices in."
  },
  "estimate_cost": {
   "type": "boolean",
   "description": "When true, only returns the SLAM token cost for this request. Does not include token price data."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "status": 200,
 "content": {
  "application/json": {
   "schema": {
    "oneOf": [
     {
      "type": "object",
      "required": [
       "block",
       "chain",
       "quote",
       "slam",
       "utc"
      ],
      "properties": {
       "utc": {
        "type": "string",
        "minLength": 1,
        "description": "UTC timestamp of this data (ISO 8601)."
       },
       "slam": {
        "type": "number",
        "format": "double",
        "description": "The SLAM token cost for this API call."
       },
       "block": {
        "type": "integer",
        "format": "int32",
        "description": "The block number for this price snapshot."
       },
       "chain": {
        "type": "string",
        "minLength": 1,
        "description": "The blockchain network name (e.g., 'base')."
       },
       "quote": {
        "type": "string",
        "minLength": 1,
        "description": "Quote token or currency (USD, ETH, BTC)."
       },
       "tokens": {
        "type": "array",
        "items": {
         "type": "object",
         "properties": {
          "fdv": {
           "type": "number",
           "format": "double",
           "nullable": true,
           "description": "Fully diluted valuation in USD."
          },
          "name": {
           "type": "string",
           "description": "Full token name."
          },
          "prev": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "change": {
              "type": "string",
              "description": "Price change percentage."
             },
             "minutes": {
              "type": "integer",
              "format": "int32",
              "description": "Lookback period in minutes."
             }
            }
           },
           "description": "Price change info over 24h."
          },
          "price": {
           "type": "number",
           "format": "double",
           "description": "Current price in selected quote."
          },
          "symbol": {
           "type": "string",
           "description": "Token symbol."
          },
          "address": {
           "type": "string",
           "description": "Token contract address."
          },
          "liquidity": {
           "type": "number",
           "format": "double",
           "nullable": true,
           "description": "Available liquidity in USD."
          }
         }
        },
        "description": "Li
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-slamai-dev-a1bea100/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.slamai.dev](https://www.zero.xyz/host/api.slamai.dev/llms.txt)
