{
  "openapi": "3.1.0",
  "info": {
    "title": "DevX Token Snapshot",
    "version": "1.0.0",
    "description": "ERC-20 token snapshot in one call on Base, Ethereum, Arbitrum, Optimism, Polygon, Avalanche, BNB Chain: USD price, FDV, total DEX liquidity, top pools (Uniswap V2/V3, Aerodrome, Velodrome, PancakeSwap, Sushi, QuickSwap, Trader Joe...), supply-in-pools/burn/owner holder hints, proxy/owner/mint/blacklist/fee risk flags. Live on-chain reads. 0.003 USDC.",
    "termsOfService": "https://token-snapshot.nextill-pos.workers.dev/terms",
    "contact": {
      "name": "DevX",
      "email": "madebydevx@gmail.com",
      "url": "https://madebydevx.com"
    },
    "x-guidance": "Call GET /v1/snapshot?token=<ERC-20 0x address>&chain=base (chains: base, ethereum, arbitrum, optimism, polygon, avalanche, bsc). Returns USD price, FDV, total DEX liquidity, top pools, holder hints and contract risk flags (proxy, owner, mint, blacklist, fees). Use it before buying, pricing or accepting an unknown token. Free name/symbol/decimals/supply lookup: GET /api/basic?token=0x...&chain=base."
  },
  "servers": [
    {
      "url": "https://token-snapshot.nextill-pos.workers.dev"
    }
  ],
  "paths": {
    "/api/basic": {
      "get": {
        "summary": "Free: ERC-20 basics (name, symbol, decimals, supply, owner/proxy presence)",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "chain",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "base",
                "ethereum",
                "arbitrum",
                "optimism",
                "polygon",
                "avalanche",
                "bsc"
              ],
              "default": "base"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "result"
          }
        },
        "security": []
      }
    },
    "/v1/snapshot": {
      "get": {
        "summary": "Paid (0.003 USDC, x402): token price, liquidity, top DEX pools, holder hints, risk flags",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "ERC-20 contract address (0x)"
          },
          {
            "name": "chain",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "base",
                "ethereum",
                "arbitrum",
                "optimism",
                "polygon",
                "avalanche",
                "bsc"
              ],
              "default": "base"
            }
          },
          {
            "name": "pools",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 10,
              "default": 5
            }
          }
        ],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.003"
          },
          "protocols": [
            {
              "x402": {}
            }
          ],
          "protocol": "x402",
          "x402Version": 2,
          "scheme": "exact",
          "network": "eip155:8453",
          "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
          "amount": "3000",
          "price_usd": 0.003,
          "payTo": "0xB3cDDccEe6B150c8efFD55B961afc0Ecefe7f247",
          "facilitator": "Coinbase CDP facilitator (api.cdp.coinbase.com/platform/v2/x402)"
        },
        "responses": {
          "200": {
            "description": "snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean"
                    },
                    "chain": {
                      "type": "string"
                    },
                    "chain_id": {
                      "type": "number"
                    },
                    "block": {
                      "type": "number"
                    },
                    "token": {
                      "type": "object",
                      "properties": {
                        "address": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        },
                        "symbol": {
                          "type": "string"
                        },
                        "decimals": {
                          "type": "number"
                        },
                        "total_supply": {
                          "type": "string"
                        }
                      }
                    },
                    "price_usd": {
                      "type": "number"
                    },
                    "price_source": {
                      "type": "object",
                      "properties": {
                        "dex": {
                          "type": "string"
                        },
                        "pool": {
                          "type": "string"
                        },
                        "pair": {
                          "type": "string"
                        }
                      }
                    },
                    "native_usd": {
                      "type": "number"
                    },
                    "fdv_usd": {
                      "type": "number"
                    },
                    "liquidity": {
                      "type": "object",
                      "properties": {
                        "total_usd": {
                          "type": "number"
                        },
                        "pools_found": {
                          "type": "number"
                        }
                      }
                    },
                    "top_pools": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "dex": {
                            "type": "string"
                          },
                          "pool": {
                            "type": "string"
                          },
                          "pair": {
                            "type": "string"
                          },
                          "fee_bps": {
                            "type": "number"
                          },
                          "price_usd": {
                            "type": "number"
                          },
                          "liquidity_usd": {
                            "type": "number"
                          }
                        }
                      }
                    },
                    "holder_hints": {
                      "type": "object",
                      "properties": {
                        "pct_supply_in_dex_pools": {
                          "type": "number"
                        },
                        "pct_burned_zero_dead": {
                          "type": "number"
                        },
                        "pct_held_by_token_contract": {
                          "type": "number"
                        },
                        "owner": {
                          "type": "string"
                        },
                        "owner_is_contract": {
                          "type": "boolean"
                        },
                        "pct_held_by_owner": {
                          "type": "number"
                        }
                      }
                    },
                    "risk": {
                      "type": "object",
                      "properties": {
                        "level": {
                          "type": "string"
                        },
                        "flags": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "level": {
                                "type": "string"
                              },
                              "detail": {
                                "type": "string"
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "chain": "base",
                  "chain_id": 8453,
                  "block": 53300018,
                  "token": {
                    "address": "0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed",
                    "name": "Degen",
                    "symbol": "DEGEN",
                    "decimals": 18,
                    "total_supply": "35926644031.72809252"
                  },
                  "price_usd": 0.000861418,
                  "price_source": {
                    "dex": "Uniswap V3",
                    "pool": "0xc9034c3e7f58003e6ae0c8438e7c8f4598d5acaa",
                    "pair": "DEGEN/WETH"
                  },
                  "native_usd": 2225.35,
                  "fdv_usd": 30947857.85,
                  "liquidity": {
                    "total_usd": 488574.5,
                    "pools_found": 26
                  },
                  "top_pools": [
                    {
                      "dex": "Uniswap V3",
                      "pool": "0xc9034c3e7f58003e6ae0c8438e7c8f4598d5acaa",
                      "pair": "DEGEN/WETH",
                      "fee_bps": 30,
                      "price_usd": 0.000861418,
                      "liquidity_usd": 245630.73
                    }
                  ],
                  "holder_hints": {
                    "pct_supply_in_dex_pools": 0.8177,
                    "pct_burned_zero_dead": 0.0006,
                    "pct_held_by_token_contract": 0.0267,
                    "owner": "0x704ec5c12ca20a293c2c0b72b22619a4231f3c0d",
                    "owner_is_contract": true,
                    "pct_held_by_owner": 0.53
                  },
                  "risk": {
                    "level": "medium",
                    "flags": [
                      {
                        "id": "owner_active",
                        "level": "info",
                        "detail": "owner 0x704e... (contract, e.g. multisig/timelock)"
                      }
                    ]
                  }
                }
              }
            }
          },
          "402": {
            "description": "Payment required (x402 v1 body + v2 PAYMENT-REQUIRED header)"
          }
        },
        "tags": [
          "token",
          "erc20",
          "price",
          "liquidity",
          "dex",
          "pools",
          "risk",
          "rug-check",
          "onchain-data",
          "base",
          "ethereum",
          "defi"
        ]
      }
    }
  },
  "tags": [
    {
      "name": "token"
    },
    {
      "name": "erc20"
    },
    {
      "name": "price"
    },
    {
      "name": "liquidity"
    },
    {
      "name": "dex"
    },
    {
      "name": "pools"
    },
    {
      "name": "risk"
    },
    {
      "name": "rug-check"
    },
    {
      "name": "onchain-data"
    },
    {
      "name": "base"
    },
    {
      "name": "ethereum"
    },
    {
      "name": "defi"
    }
  ]
}