# FiatDock Token Report — Price + Liquidity + Safety in One Call

> FiatDock Token Report — Price + Liquidity + Safety in One Call is a paid API for AI agents from fiatdock.com, paid per call via x402, $0.0045/call, status unknown (last checked 2026-10-10).

Returns a combined price, liquidity, and full on-chain safety verdict for any ERC-20 token in a single API call by aggregating DexScreener and GoPlus data.

## Facts

- Endpoint: GET https://fiatdock.com/v1/chain/token-report?utm_source=zero.xyz
- Price: $0.0045/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fiatdock-token-report-price-liquidity-safety-in-one-call-aaee5a9d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__aYE7_NglglF6Tco3kLOg

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 fiatdock-token-report-price-liquidity-safety-in-one-call-aaee5a9d
```

Example prompt: Can you pull a full token report for the USDC contract at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — I want the current price, liquidity, 24h volume, and a safety verdict including honeypot check and holder concentration?

## When to prefer this

Choose this endpoint when you need BOTH price/liquidity data AND a safety verdict for an ERC-20 token in a single round-trip — it saves you from chaining a separate DexScreener price call and a GoPlus safety call, at one flat $0.05 USDC fee instead of two payments. Prefer it over the sibling 'token_safety' endpoint when you also need current price, liquidity, and volume context. Best suited for pre-trade screening, DeFi bot token filtering, or investor due diligence workflows on Base or other supported EVM chains.

## Known failure modes

- Token address not found on DexScreener — returns empty price block or null fields
- GoPlus scan unavailable for the given chain — safety verdict may be incomplete
- Invalid or malformed token address — returns 4xx error
- Unsupported chain ID — endpoint may return an error or empty result
- Token has no liquidity pairs indexed — price fields return null
- Payment not received or x402 flow fails — request rejected before processing

## How this service works

Token report — price + liquidity + full safety verdict for any ERC-20 in ONE call (DexScreener + GoPlus). One payment instead of chaining token_price + token_safety. Pay-per-call via x402. An empty body is answered for USDC on Base (the x402 settlement asset); send {"token":"0x…"} for any other token.

## Output

A JSON object containing: token name, symbol, address, network, timestamp; price data (USD price, 5m/1h/6h/24h price changes, liquidity USD, 24h volume, market cap, FDV, top DEX pair with address and quote asset); safety data (honeypot flag, buy/sell tax percentages, mintable flag, proxy flag, open-source flag, holder count, top holder percentage, LP locked percentage, CEX listing status, list of detected risks, and a textual verdict reason); an overall 'safe/warning/danger' verdict; and data source attribution.

## 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": [],
     "properties": {
      "chain": {
       "type": "string",
       "description": "base (default) | ethereum | polygon | arbitrum | optimism | bsc | avalanche"
      },
      "token": {
       "type": "string",
       "description": "ERC-20 contract address (0x + 40 hex). Omit the whole body to get USDC on Base."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "asOf": "2026-07-30T00:00:00.000Z",
  "name": "USD Coin",
  "note": "One-call token report — not financial advice.",
  "price": {
   "fdvUsd": null,
   "topPair": {
    "dex": "uniswap",
    "url": "https://dexscreener.com/base/0xpair",
    "quote": "WETH",
    "pairAddress": "0xpair"
   },
   "priceUsd": 1.0001,
   "priceChange": {
    "h1": 0,
    "h6": 0,
    "m5": 0,
    "h24": 0.01
   },
   "liquidityUsd": 5000000,
   "marketCapUsd": null,
   "volume24hUsd": 1234567
  },
  "safety": {
   "risks": [],
   "isProxy": false,
   "verdict": "safe",
   "buyTaxPct": 0,
   "isHoneypot": false,
   "isMintable": false,
   "sellTaxPct": 0,
   "holderCount": 12688934,
   "listedOnCex": true,
   "lpLockedPct": null,
   "isOpenSource": true,
   "topHolderPct": 12.4,
   "verdictReason": "No critical risks detected by the on-chain security scan."
  },
  "source": "DexScreener (most-liquid pair) + GoPlus Security on-chain scan",
  "symbol": "USDC",
  "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "network": "base",
  "verdict": "safe"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fiatdock-token-report-price-liquidity-safety-in-one-call-aaee5a9d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fiatdock.com](https://www.zero.xyz/host/fiatdock.com/llms.txt)