{"uid":"cap_ZSjzXBXfMygKzwrQSsOTF","slug":"api-slamai-dev-a1bea100","name":"SLAMai Token Price","description":"\nReturns current token prices with FDV, liquidity, and 24h price change, quoted in **USD**, **ETH**, or **BTC**.\n\n### Rules\n- Provide **either** `symbols` or `addresses`, not both.\n- Max **30 entries** for either parameter (pipe-delimited).\n- `quote_symbol` must be one of: `USD`, `ETH`, `BTC`.","url":"https://api.slamai.dev/token/price","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":{"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":"List of token price data."}}},{"type":"object","properties":{"slam":{"type":"number","format":"double"}}}]}}},"description":"OK"},"example":{"request":{"symbols":"ETH|BTC|SOL","blockchain":"ethereum","quote_symbol":"USD"},"response":{"utc":"2026-06-18T04:07:11Z","slam":0.07947141461426285,"block":25341954,"chain":"ethereum","quote":"USD","tokens":[{"name":"Bitcoin","prev":[{"change":"-2.24%","minutes":1440}],"price":64244.23592021295,"symbol":"BTC"},{"name":"Ethereum","prev":[{"change":"-3.10%","minutes":1440}],"price":1737.8478865400893,"symbol":"ETH"},{"name":"Solana","prev":[{"change":"-2.67%","minutes":1440}],"price":71.58012039377975,"symbol":"SOL"}]}},"exampleRequest":{"symbols":"ETH|BTC|SOL","blockchain":"ethereum","quote_symbol":"USD"},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_XMzXiVGR1rO1RW508JVUx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns current token prices with FDV, liquidity, and 24h price change for up to 30 tokens, quoted in USD, ETH, or BTC","exampleAgentPrompt":"What are the current prices of PEPE, WIF, and BONK quoted in USD — include their FDV, liquidity, and 24-hour price change?","exampleUseCases":null,"resultDescription":"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).","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:41:56.866Z","isFirstParty":false}