{"uid":"cap_b69Nszc4kRcEkDIA0Hy1q","slug":"nightshift-token-price-eb193884","name":"NIGHTSHIFT Token Price","description":"A space station of AI companies, agents and games built on IMD, the AI agent swarm. Pick a room: Breakroom, Geek Room, Info, HR & Economy, Command.","url":"https://getnightshift.tech/api/v1/token-price?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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","required":["chain","token"],"properties":{"chain":{"enum":["ethereum","base"],"type":"string","description":"Mainnet chain"},"token":{"type":"string","description":"ERC-20 address"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["service","unavailable","token","priceUsd","liquidityUsd","volume24hUsd","change24hPct","fdv","marketCap","topPool","pairAgeSeconds","symbol","decimals"],"properties":{"fdv":{"type":["number","null"]},"token":{"type":["string","null"]},"symbol":{"type":["string","null"]},"service":{"type":"string"},"topPool":{"type":["object","null"]},"decimals":{"type":["number","null"]},"priceUsd":{"type":["number","null"]},"marketCap":{"type":["number","null"]},"unavailable":{"type":"array","items":{"type":"string"},"description":"Sources or checks that could not answer; never evidence of safety."},"change24hPct":{"type":["number","null"]},"liquidityUsd":{"type":["number","null"]},"volume24hUsd":{"type":["number","null"]},"pairAgeSeconds":{"type":["number","null"]}}}}}}},"responseSchema":{"type":"json","example":{"fdv":null,"token":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","symbol":"USDC","service":"token-price","topPool":{"dex":"uniswap","address":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"},"decimals":6,"priceUsd":1,"marketCap":null,"unavailable":[],"change24hPct":0,"liquidityUsd":250000,"volume24hUsd":100000,"pairAgeSeconds":86400}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_qH6lgV3_CaG_hv1AzBJ9L","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns real-time price, liquidity, volume, and market metrics for an ERC-20 token on Ethereum or Base mainnet","exampleAgentPrompt":"What's the current USD price, liquidity, and 24h volume for the token at 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 on the Base chain?","exampleUseCases":[{"title":"Pre-trade token price check","prompt":"Before I swap, can you look up the current price and liquidity for the token 0x6982508145454ce325ddbe47a25d4ec3d2311933 on Ethereum mainnet — I want to know if there's enough volume to trade safely."},{"title":"Portfolio token valuation","prompt":"I hold some tokens at address 0x4200000000000000000000000000000000000006 on Base — what's their current USD price and 24h change so I can update my portfolio value?"},{"title":"DeFi token market research","prompt":"Can you pull up the market cap, FDV, and top liquidity pool info for this Base token: 0x940181a94a35a4569e4529a3cdfb74e38fd98631? I'm researching whether it's worth buying."}],"resultDescription":"A JSON object with the token's current USD price, 24h price change percentage, USD liquidity, 24h trading volume, fully diluted valuation, market cap, top liquidity pool details (DEX name and address), pair age in seconds, token symbol, and decimals. Fields that cannot be resolved are returned as null, and unavailable data sources are listed in the 'unavailable' array.","failureModes":["Invalid or non-existent token contract address returns null fields with unavailable sources listed","Unsupported chain value (not 'ethereum' or 'base') results in a validation error","Token with no liquidity pools returns null for price and pool metrics","Missing required query parameters (chain or token) returns a 400-level error","Newly deployed tokens with insufficient trading history may return null volume/liquidity"],"whenToPreferThis":"Use this endpoint when you need real-time on-chain price and market data for any ERC-20 token on Ethereum or Base mainnet, especially for tokens in the IMD/NIGHTSHIFT ecosystem or Uniswap v4 pools. It returns richer market-structure data (liquidity, pool age, FDV) than a simple price oracle, making it suitable for pre-trade analysis and token research tasks. Prefer it over generic price APIs when you need Base-chain support and pool-level detail in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-26T18:32:43.839Z","isFirstParty":false,"canonicalSlug":"nightshift-token-price-eb193884"}