# NIGHTSHIFT Token Price

> NIGHTSHIFT Token Price is a paid API for AI agents from getnightshift.tech, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-26).

Returns real-time price, liquidity, volume, and market metrics for an ERC-20 token on Ethereum or Base mainnet

## Facts

- Endpoint: GET https://getnightshift.tech/api/v1/token-price?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-26
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nightshift-token-price-eb193884
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_b69Nszc4kRcEkDIA0Hy1q

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 nightshift-token-price-eb193884
```

Example prompt: What's the current USD price, liquidity, and 24h volume for the token at 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 on the Base chain?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## 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",
     "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"
       ]
      }
     }
    }
   }
  
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nightshift-token-price-eb193884/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from getnightshift.tech](https://www.zero.xyz/host/getnightshift.tech/llms.txt)