{
  "openapi": "3.1.0",
  "info": {
    "title": "Nodetrail x402 scan API",
    "version": "1.0.0",
    "description": "Pay-per-scan x402 v2 API. Read-only on-chain facts and a Low, Elevated or High risk signal for a token or wallet on 61 chains (Nodetrail scanning for Hyperliquid is coming soon). Pay in USDC on Base (eip155:8453) or Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp) through the Coinbase CDP facilitator. Quick token scans cost $0.02, wallet scans $0.05 and deep scans $0.07. The read runs before settlement, so you are only charged if the scan is delivered. On Base no approvals and no ETH are needed; on Solana the quote's fee payer covers the fee for API clients. Wallet scans work on solana, base, tron, sui, near, xrpl, ton, hedera, cardano, aptos, movement, injective, stacks, starknet, multiversx, algorand, icp, polkadot and stellar only. A risk signal is not a verdict. A Nodetrail token is in the works, but no token exists yet and there is no contract address. Anyone selling one today is not us.",
    "termsOfService": "https://nodetrail.io/terms/",
    "contact": {
      "url": "https://nodetrail.io/contact/",
      "email": "support@nodetrail.io"
    },
    "x-guidance": "Nodetrail reads public chain data for a token or wallet and returns facts plus a Low, Elevated or High risk signal. Call GET /api/x402/v1/scan/token for a quick token scan ($0.02), GET /api/x402/v1/scan/wallet for a quick wallet scan ($0.05, on solana, base, tron, sui, near, xrpl, ton, hedera, cardano, aptos, movement, injective, stacks, starknet, multiversx, algorand, icp, polkadot and stellar only) or GET /api/x402/v1/scan/dev for a deep scan ($0.07). Pass address and, for anything other than a Solana mint or a Base 0x address, chain (any of the 61 chain ids listed at https://nodetrail.io/llms.txt). Pay in USDC on Base or Solana with x402 v2. You are only charged if the scan is delivered.",
    "x-nodetrail-catalog": {
      "version": "prices3-2026-11-18",
      "note": "Live means you can buy or use it today. Coming soon and Planned items cannot be bought yet. Telegram Stars price = the USD price divided by 1.3¢ per Star, rounded up. USDC scan prices do not change with plans. Stablecoins (USDC, USDT) pay the listed price with no discount. The 10% crypto discount is for non-stablecoins only. SOL (Solana) and ETH (Base) show Live on the scan page where that option is switched on, and Coming soon everywhere else; other non-stablecoins are coming soon.",
      "items": [
        {
          "group": "Pay per scan (USDC, x402)",
          "name": "Quick token scan",
          "price": "2¢",
          "status": "Live"
        },
        {
          "group": "Pay per scan (USDC, x402)",
          "name": "Wallet scan",
          "price": "5¢",
          "status": "Live"
        },
        {
          "group": "Pay per scan (USDC, x402)",
          "name": "Deep token check",
          "price": "7¢",
          "status": "Live"
        },
        {
          "group": "Monthly plans (card, via Stripe)",
          "name": "Trail",
          "price": "$24.99 / month",
          "status": "Live"
        },
        {
          "group": "Monthly plans (card, via Stripe)",
          "name": "Pro",
          "price": "$59.99 / month",
          "status": "Live"
        },
        {
          "group": "Monthly plans (card, via Stripe)",
          "name": "Team",
          "price": "$109.99 / month",
          "status": "Live"
        },
        {
          "group": "Pay in crypto",
          "name": "Pay in SOL (Solana)",
          "price": "10% off the listed price",
          "status": "Coming soon; shows Live on the scan page where it is switched on"
        },
        {
          "group": "Pay in crypto",
          "name": "Pay in ETH (Base)",
          "price": "10% off the listed price",
          "status": "Coming soon; shows Live on the scan page where it is switched on"
        },
        {
          "group": "Pay in crypto",
          "name": "Pay in another non-stablecoin",
          "price": "10% off the listed price",
          "status": "Coming soon"
        },
        {
          "group": "Same plans in @nodetrailbot with Telegram Stars",
          "name": "Trail (Telegram Stars)",
          "price": "1,923⭐ / month",
          "status": "Coming soon"
        },
        {
          "group": "Same plans in @nodetrailbot with Telegram Stars",
          "name": "Pro (Telegram Stars)",
          "price": "4,615⭐ / month",
          "status": "Coming soon"
        },
        {
          "group": "Same plans in @nodetrailbot with Telegram Stars",
          "name": "Team (Telegram Stars)",
          "price": "8,461⭐ / month",
          "status": "Coming soon"
        },
        {
          "group": "Yearly plans (12 months for the price of 10)",
          "name": "Trail, yearly",
          "price": "$249.90 / year",
          "status": "Coming soon"
        },
        {
          "group": "Yearly plans (12 months for the price of 10)",
          "name": "Pro, yearly",
          "price": "$599.90 / year",
          "status": "Coming soon"
        },
        {
          "group": "Yearly plans (12 months for the price of 10)",
          "name": "Team, yearly",
          "price": "$1,099.90 / year",
          "status": "Coming soon"
        },
        {
          "group": "Bundles (pay once and save)",
          "name": "Ape Pack, 150 scans",
          "price": "$9.99",
          "status": "Coming soon"
        },
        {
          "group": "Bundles (pay once and save)",
          "name": "Ape Pack, 500 scans",
          "price": "$24.99",
          "status": "Coming soon"
        },
        {
          "group": "Bundles (pay once and save)",
          "name": "Bot Fuel, 1,000 scans (this month's deal)",
          "price": "$49",
          "status": "Coming soon"
        },
        {
          "group": "Bundles (pay once and save)",
          "name": "Call Group Pass",
          "price": "$99 / month",
          "status": "Coming soon"
        },
        {
          "group": "Add-ons and deals",
          "name": "Pro add-on",
          "price": "$4.99 / month",
          "status": "Coming soon"
        },
        {
          "group": "Add-ons and deals",
          "name": "Afterguard alerts",
          "price": "$38.99 / month",
          "status": "Coming soon"
        },
        {
          "group": "Add-ons and deals",
          "name": "API entry plan",
          "price": "$53.99 / month",
          "status": "Coming soon"
        },
        {
          "group": "Add-ons and deals",
          "name": "Telegram group plan",
          "price": "$133.99 / month per group",
          "status": "Coming soon"
        },
        {
          "group": "Add-ons and deals",
          "name": "Blockchain Buddy Plus",
          "price": "$4.99 / month",
          "status": "Coming soon"
        },
        {
          "group": "Add-ons and deals",
          "name": "Scan trio",
          "price": "13¢ total",
          "status": "Coming soon"
        },
        {
          "group": "Add-ons and deals",
          "name": "Blockchain Buddy Welcome Pack",
          "price": "+100 checks, first month",
          "status": "Planned"
        },
        {
          "group": "Add-ons and deals",
          "name": "Buddy Bonus",
          "price": "25 checks each",
          "status": "Planned"
        },
        {
          "group": "For bots and agents",
          "name": "API Starter",
          "price": "$49 / month",
          "status": "Coming soon"
        },
        {
          "group": "For bots and agents",
          "name": "API Pro",
          "price": "$199 / month",
          "status": "Coming soon"
        },
        {
          "group": "For bots and agents",
          "name": "API Starter, yearly",
          "price": "$490 / year",
          "status": "Coming soon"
        },
        {
          "group": "For bots and agents",
          "name": "API Pro, yearly",
          "price": "$1,990 / year",
          "status": "Coming soon"
        },
        {
          "group": "For bots and agents",
          "name": "Agent bundle",
          "price": "$59 / month",
          "status": "Coming soon"
        }
      ]
    }
  },
  "servers": [
    {
      "url": "https://nodetrail.io",
      "description": "Production"
    }
  ],
  "paths": {
    "/api/x402/v1/info": {
      "get": {
        "operationId": "getX402Info",
        "summary": "Prices, networks and status (no payment)",
        "description": "No payment. Lists prices, networks, endpoints, paid chains and whether payments and scanning are open.",
        "responses": {
          "200": {
            "description": "Status JSON",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "404": {
            "description": "Switched off on this host"
          }
        }
      }
    },
    "/api/x402/v1/scan/token": {
      "get": {
        "operationId": "scanToken",
        "summary": "Quick token scan ($0.02)",
        "description": "Quick token scan on any of the 61 chains. Price $0.02 (20000 atomic USDC).",
        "parameters": [
          {
            "name": "address",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Token mint or contract, coin type (Sui), account (NEAR) or wallet address. `mint` and `wallet` are accepted as aliases."
          },
          {
            "name": "chain",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "solana",
                "ethereum",
                "base",
                "bnb",
                "robinhood",
                "arbitrum",
                "tron",
                "polygon",
                "avalanche",
                "sui",
                "near",
                "xrpl",
                "ton",
                "optimism",
                "monad",
                "unichain",
                "mantle",
                "berachain",
                "sei",
                "ink",
                "xlayer",
                "arc",
                "cronos",
                "worldchain",
                "sonic",
                "linea",
                "zksync",
                "plasma",
                "stable",
                "celo",
                "beam",
                "scroll",
                "taiko",
                "katana",
                "ronin",
                "kaia",
                "soneium",
                "flare",
                "megaeth",
                "story",
                "hedera",
                "apechain",
                "flowevm",
                "fuse",
                "kava",
                "manta",
                "metis",
                "telos",
                "merlin",
                "elysium",
                "cardano",
                "aptos",
                "movement",
                "injective",
                "stacks",
                "starknet",
                "multiversx",
                "algorand",
                "icp",
                "polkadot",
                "stellar"
              ]
            },
            "description": "Chain key. If omitted: a 40-character 0x address is read as base, an address containing :: as sui, anything else as solana."
          },
          {
            "name": "currency",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "XRP Ledger only: currency code when `address` is an issuer."
          }
        ],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.020000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ],
          "currency": "USDC",
          "networks": [
            "eip155:8453",
            "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"
          ]
        },
        "responses": {
          "200": {
            "description": "Paid scan result.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "const": true
                    },
                    "kind": {
                      "type": "string"
                    },
                    "chain": {
                      "type": "string",
                      "enum": [
                        "solana",
                        "ethereum",
                        "base",
                        "bnb",
                        "robinhood",
                        "arbitrum",
                        "tron",
                        "polygon",
                        "avalanche",
                        "sui",
                        "near",
                        "xrpl",
                        "ton",
                        "optimism",
                        "monad",
                        "unichain",
                        "mantle",
                        "berachain",
                        "sei",
                        "ink",
                        "xlayer",
                        "arc",
                        "cronos",
                        "worldchain",
                        "sonic",
                        "linea",
                        "zksync",
                        "plasma",
                        "stable",
                        "celo",
                        "beam",
                        "scroll",
                        "taiko",
                        "katana",
                        "ronin",
                        "kaia",
                        "soneium",
                        "flare",
                        "megaeth",
                        "story",
                        "hedera",
                        "apechain",
                        "flowevm",
                        "fuse",
                        "kava",
                        "manta",
                        "metis",
                        "telos",
                        "merlin",
                        "elysium",
                        "cardano",
                        "aptos",
                        "movement",
                        "injective",
                        "stacks",
                        "starknet",
                        "multiversx",
                        "algorand",
                        "icp",
                        "polkadot",
                        "stellar"
                      ]
                    },
                    "chainName": {
                      "type": "string"
                    },
                    "address": {
                      "type": "string"
                    },
                    "type": {
                      "type": "string",
                      "enum": [
                        "token",
                        "wallet"
                      ]
                    },
                    "level": {
                      "type": "string",
                      "enum": [
                        "Low",
                        "Elevated",
                        "High",
                        "Unknown"
                      ]
                    },
                    "findings": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "headline": {
                      "type": "object"
                    },
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "facts": {
                      "type": "object"
                    },
                    "coverage": {
                      "type": "object",
                      "properties": {
                        "sources": {
                          "type": "array",
                          "items": {}
                        },
                        "not_checked": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "note": {
                          "type": "string"
                        }
                      }
                    },
                    "source": {
                      "type": "string"
                    },
                    "read_ms": {
                      "type": "number"
                    },
                    "cached": {
                      "type": "boolean"
                    },
                    "live_read": {
                      "type": "boolean"
                    },
                    "paid": {
                      "type": "boolean"
                    },
                    "bucket": {
                      "type": "string",
                      "enum": [
                        "quick",
                        "deep"
                      ]
                    },
                    "settlement": {
                      "type": "object",
                      "properties": {
                        "network": {
                          "type": "string"
                        },
                        "transaction": {
                          "type": "string"
                        },
                        "payer": {
                          "type": [
                            "string",
                            "null"
                          ]
                        }
                      }
                    },
                    "disclaimer": {
                      "type": "string"
                    },
                    "data_age_s": {
                      "type": "number",
                      "description": "Age of the chain read in seconds. 0 means just read. Reads may be reused up to 8 minutes (token, deep) or 2 minutes (wallet)."
                    }
                  },
                  "required": [
                    "ok",
                    "level",
                    "paid",
                    "disclaimer"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad address, unsupported chain or scan type. Returned before any 402 quote, so no payment is signed for a request that cannot run. Not charged.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "const": false
                    },
                    "charged": {
                      "const": false
                    },
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ]
                    }
                  },
                  "required": [
                    "ok",
                    "error"
                  ]
                }
              }
            }
          },
          "401": {
            "description": "API-key requests only (monthly API plans, not switched on yet): the key is missing, malformed, unknown or revoked. Keyless x402 requests never get 401."
          },
          "402": {
            "description": "Payment required. The PAYMENT-REQUIRED header (base64 JSON, x402 v2) lists the exact amount, asset, network and payTo for each rail. The JSON body carries the same quote (price, x402Version, accepts) for clients that read only the body. Repeat the request with a PAYMENT-SIGNATURE header.",
            "headers": {
              "PAYMENT-REQUIRED": {
                "schema": {
                  "type": "string"
                },
                "description": "base64 JSON x402 v2 payment requirements"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "const": false
                    },
                    "price": {
                      "type": "object",
                      "properties": {
                        "usd": {
                          "type": "string"
                        },
                        "atomic": {
                          "type": "string"
                        },
                        "decimals": {
                          "type": "integer"
                        },
                        "asset": {
                          "type": "string"
                        }
                      }
                    },
                    "x402Version": {
                      "type": "integer"
                    },
                    "accepts": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "error": {
                      "type": "object"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "API-key requests only: the plan is not active (payment failed, paused or cancelled) or the scan type is not in the plan."
          },
          "409": {
            "description": "That payment was already used. Not charged again.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "const": false
                    },
                    "charged": {
                      "const": false
                    },
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ]
                    }
                  },
                  "required": [
                    "ok",
                    "error"
                  ]
                }
              }
            }
          },
          "429": {
            "description": "A spend limit was reached. Not charged. With an API key: per-second rate limit (rate_limited) or daily unique-scan quota reached (quota_exceeded); see Retry-After and X-Quota-* headers.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "const": false
                    },
                    "charged": {
                      "const": false
                    },
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ]
                    }
                  },
                  "required": [
                    "ok",
                    "error"
                  ]
                }
              }
            }
          },
          "502": {
            "description": "The read did not finish. Not charged. Try again.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "const": false
                    },
                    "charged": {
                      "const": false
                    },
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ]
                    }
                  },
                  "required": [
                    "ok",
                    "error"
                  ]
                }
              }
            }
          },
          "503": {
            "description": "That chain is not switched on, or scanning is closed. Refused before any charge.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "const": false
                    },
                    "charged": {
                      "const": false
                    },
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ]
                    }
                  },
                  "required": [
                    "ok",
                    "error"
                  ]
                }
              }
            }
          },
          "504": {
            "description": "A data source was too slow, so the read did not finish in time. Not charged. Try again in a few seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "const": false
                    },
                    "charged": {
                      "const": false
                    },
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ]
                    }
                  },
                  "required": [
                    "ok",
                    "error"
                  ]
                }
              }
            }
          }
        },
        "security": [
          {},
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ]
      }
    },
    "/api/x402/v1/scan/wallet": {
      "get": {
        "operationId": "scanWallet",
        "summary": "Quick wallet scan ($0.05)",
        "description": "Quick wallet scan. Works on solana, base, tron, sui, near, xrpl, ton, hedera, cardano, aptos, movement, injective, stacks, starknet, multiversx, algorand, icp, polkadot and stellar only. Price $0.05 (50000 atomic USDC).",
        "parameters": [
          {
            "name": "address",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Token mint or contract, coin type (Sui), account (NEAR) or wallet address. `mint` and `wallet` are accepted as aliases."
          },
          {
            "name": "chain",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "solana",
                "ethereum",
                "base",
                "bnb",
                "robinhood",
                "arbitrum",
                "tron",
                "polygon",
                "avalanche",
                "sui",
                "near",
                "xrpl",
                "ton",
                "optimism",
                "monad",
                "unichain",
                "mantle",
                "berachain",
                "sei",
                "ink",
                "xlayer",
                "arc",
                "cronos",
                "worldchain",
                "sonic",
                "linea",
                "zksync",
                "plasma",
                "stable",
                "celo",
                "beam",
                "scroll",
                "taiko",
                "katana",
                "ronin",
                "kaia",
                "soneium",
                "flare",
                "megaeth",
                "story",
                "hedera",
                "apechain",
                "flowevm",
                "fuse",
                "kava",
                "manta",
                "metis",
                "telos",
                "merlin",
                "elysium",
                "cardano",
                "aptos",
                "movement",
                "injective",
                "stacks",
                "starknet",
                "multiversx",
                "algorand",
                "icp",
                "polkadot",
                "stellar"
              ]
            },
            "description": "Chain key. Wallet scans work on solana, base, tron, sui, near, xrpl, ton, hedera, cardano, aptos, movement, injective, stacks, starknet, multiversx, algorand, icp, polkadot and stellar only. If omitted: a 40-character 0x address is read as base, an address containing :: as sui, anything else as solana."
          },
          {
            "name": "currency",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "XRP Ledger only: currency code when `address` is an issuer."
          }
        ],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.050000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ],
          "currency": "USDC",
          "networks": [
            "eip155:8453",
            "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"
          ]
        },
        "responses": {
          "200": {
            "description": "Paid scan result.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "const": true
                    },
                    "kind": {
                      "type": "string"
                    },
                    "chain": {
                      "type": "string",
                      "enum": [
                        "solana",
                        "ethereum",
                        "base",
                        "bnb",
                        "robinhood",
                        "arbitrum",
                        "tron",
                        "polygon",
                        "avalanche",
                        "sui",
                        "near",
                        "xrpl",
                        "ton",
                        "optimism",
                        "monad",
                        "unichain",
                        "mantle",
                        "berachain",
                        "sei",
                        "ink",
                        "xlayer",
                        "arc",
                        "cronos",
                        "worldchain",
                        "sonic",
                        "linea",
                        "zksync",
                        "plasma",
                        "stable",
                        "celo",
                        "beam",
                        "scroll",
                        "taiko",
                        "katana",
                        "ronin",
                        "kaia",
                        "soneium",
                        "flare",
                        "megaeth",
                        "story",
                        "hedera",
                        "apechain",
                        "flowevm",
                        "fuse",
                        "kava",
                        "manta",
                        "metis",
                        "telos",
                        "merlin",
                        "elysium",
                        "cardano",
                        "aptos",
                        "movement",
                        "injective",
                        "stacks",
                        "starknet",
                        "multiversx",
                        "algorand",
                        "icp",
                        "polkadot",
                        "stellar"
                      ]
                    },
                    "chainName": {
                      "type": "string"
                    },
                    "address": {
                      "type": "string"
                    },
                    "type": {
                      "type": "string",
                      "enum": [
                        "token",
                        "wallet"
                      ]
                    },
                    "level": {
                      "type": "string",
                      "enum": [
                        "Low",
                        "Elevated",
                        "High",
                        "Unknown"
                      ]
                    },
                    "findings": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "headline": {
                      "type": "object"
                    },
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "facts": {
                      "type": "object"
                    },
                    "coverage": {
                      "type": "object",
                      "properties": {
                        "sources": {
                          "type": "array",
                          "items": {}
                        },
                        "not_checked": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "note": {
                          "type": "string"
                        }
                      }
                    },
                    "source": {
                      "type": "string"
                    },
                    "read_ms": {
                      "type": "number"
                    },
                    "cached": {
                      "type": "boolean"
                    },
                    "live_read": {
                      "type": "boolean"
                    },
                    "paid": {
                      "type": "boolean"
                    },
                    "bucket": {
                      "type": "string",
                      "enum": [
                        "quick",
                        "deep"
                      ]
                    },
                    "settlement": {
                      "type": "object",
                      "properties": {
                        "network": {
                          "type": "string"
                        },
                        "transaction": {
                          "type": "string"
                        },
                        "payer": {
                          "type": [
                            "string",
                            "null"
                          ]
                        }
                      }
                    },
                    "disclaimer": {
                      "type": "string"
                    },
                    "data_age_s": {
                      "type": "number",
                      "description": "Age of the chain read in seconds. 0 means just read. Reads may be reused up to 8 minutes (token, deep) or 2 minutes (wallet)."
                    }
                  },
                  "required": [
                    "ok",
                    "level",
                    "paid",
                    "disclaimer"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad address, unsupported chain or scan type. Returned before any 402 quote, so no payment is signed for a request that cannot run. Not charged.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "const": false
                    },
                    "charged": {
                      "const": false
                    },
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ]
                    }
                  },
                  "required": [
                    "ok",
                    "error"
                  ]
                }
              }
            }
          },
          "401": {
            "description": "API-key requests only (monthly API plans, not switched on yet): the key is missing, malformed, unknown or revoked. Keyless x402 requests never get 401."
          },
          "402": {
            "description": "Payment required. The PAYMENT-REQUIRED header (base64 JSON, x402 v2) lists the exact amount, asset, network and payTo for each rail. The JSON body carries the same quote (price, x402Version, accepts) for clients that read only the body. Repeat the request with a PAYMENT-SIGNATURE header.",
            "headers": {
              "PAYMENT-REQUIRED": {
                "schema": {
                  "type": "string"
                },
                "description": "base64 JSON x402 v2 payment requirements"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "const": false
                    },
                    "price": {
                      "type": "object",
                      "properties": {
                        "usd": {
                          "type": "string"
                        },
                        "atomic": {
                          "type": "string"
                        },
                        "decimals": {
                          "type": "integer"
                        },
                        "asset": {
                          "type": "string"
                        }
                      }
                    },
                    "x402Version": {
                      "type": "integer"
                    },
                    "accepts": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "error": {
                      "type": "object"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "API-key requests only: the plan is not active (payment failed, paused or cancelled) or the scan type is not in the plan."
          },
          "409": {
            "description": "That payment was already used. Not charged again.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "const": false
                    },
                    "charged": {
                      "const": false
                    },
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ]
                    }
                  },
                  "required": [
                    "ok",
                    "error"
                  ]
                }
              }
            }
          },
          "429": {
            "description": "A spend limit was reached. Not charged. With an API key: per-second rate limit (rate_limited) or daily unique-scan quota reached (quota_exceeded); see Retry-After and X-Quota-* headers.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "const": false
                    },
                    "charged": {
                      "const": false
                    },
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ]
                    }
                  },
                  "required": [
                    "ok",
                    "error"
                  ]
                }
              }
            }
          },
          "502": {
            "description": "The read did not finish. Not charged. Try again.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "const": false
                    },
                    "charged": {
                      "const": false
                    },
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ]
                    }
                  },
                  "required": [
                    "ok",
                    "error"
                  ]
                }
              }
            }
          },
          "503": {
            "description": "That chain is not switched on, or scanning is closed. Refused before any charge.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "const": false
                    },
                    "charged": {
                      "const": false
                    },
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ]
                    }
                  },
                  "required": [
                    "ok",
                    "error"
                  ]
                }
              }
            }
          },
          "504": {
            "description": "A data source was too slow, so the read did not finish in time. Not charged. Try again in a few seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "const": false
                    },
                    "charged": {
                      "const": false
                    },
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ]
                    }
                  },
                  "required": [
                    "ok",
                    "error"
                  ]
                }
              }
            }
          }
        },
        "security": [
          {},
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ]
      }
    },
    "/api/x402/v1/scan/dev": {
      "get": {
        "operationId": "scanDeep",
        "summary": "Deep scan ($0.07)",
        "description": "Deep scan on any of the 61 chains: the quick read plus the extra checks the chain allows. Price $0.07 (70000 atomic USDC).",
        "parameters": [
          {
            "name": "address",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Token mint or contract, coin type (Sui), account (NEAR) or wallet address. `mint` and `wallet` are accepted as aliases."
          },
          {
            "name": "chain",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "solana",
                "ethereum",
                "base",
                "bnb",
                "robinhood",
                "arbitrum",
                "tron",
                "polygon",
                "avalanche",
                "sui",
                "near",
                "xrpl",
                "ton",
                "optimism",
                "monad",
                "unichain",
                "mantle",
                "berachain",
                "sei",
                "ink",
                "xlayer",
                "arc",
                "cronos",
                "worldchain",
                "sonic",
                "linea",
                "zksync",
                "plasma",
                "stable",
                "celo",
                "beam",
                "scroll",
                "taiko",
                "katana",
                "ronin",
                "kaia",
                "soneium",
                "flare",
                "megaeth",
                "story",
                "hedera",
                "apechain",
                "flowevm",
                "fuse",
                "kava",
                "manta",
                "metis",
                "telos",
                "merlin",
                "elysium",
                "cardano",
                "aptos",
                "movement",
                "injective",
                "stacks",
                "starknet",
                "multiversx",
                "algorand",
                "icp",
                "polkadot",
                "stellar"
              ]
            },
            "description": "Chain key. If omitted: a 40-character 0x address is read as base, an address containing :: as sui, anything else as solana."
          },
          {
            "name": "currency",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "XRP Ledger only: currency code when `address` is an issuer."
          }
        ],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.070000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ],
          "currency": "USDC",
          "networks": [
            "eip155:8453",
            "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"
          ]
        },
        "responses": {
          "200": {
            "description": "Paid scan result.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "const": true
                    },
                    "kind": {
                      "type": "string"
                    },
                    "chain": {
                      "type": "string",
                      "enum": [
                        "solana",
                        "ethereum",
                        "base",
                        "bnb",
                        "robinhood",
                        "arbitrum",
                        "tron",
                        "polygon",
                        "avalanche",
                        "sui",
                        "near",
                        "xrpl",
                        "ton",
                        "optimism",
                        "monad",
                        "unichain",
                        "mantle",
                        "berachain",
                        "sei",
                        "ink",
                        "xlayer",
                        "arc",
                        "cronos",
                        "worldchain",
                        "sonic",
                        "linea",
                        "zksync",
                        "plasma",
                        "stable",
                        "celo",
                        "beam",
                        "scroll",
                        "taiko",
                        "katana",
                        "ronin",
                        "kaia",
                        "soneium",
                        "flare",
                        "megaeth",
                        "story",
                        "hedera",
                        "apechain",
                        "flowevm",
                        "fuse",
                        "kava",
                        "manta",
                        "metis",
                        "telos",
                        "merlin",
                        "elysium",
                        "cardano",
                        "aptos",
                        "movement",
                        "injective",
                        "stacks",
                        "starknet",
                        "multiversx",
                        "algorand",
                        "icp",
                        "polkadot",
                        "stellar"
                      ]
                    },
                    "chainName": {
                      "type": "string"
                    },
                    "address": {
                      "type": "string"
                    },
                    "type": {
                      "type": "string",
                      "enum": [
                        "token",
                        "wallet"
                      ]
                    },
                    "level": {
                      "type": "string",
                      "enum": [
                        "Low",
                        "Elevated",
                        "High",
                        "Unknown"
                      ]
                    },
                    "findings": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "headline": {
                      "type": "object"
                    },
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "facts": {
                      "type": "object"
                    },
                    "coverage": {
                      "type": "object",
                      "properties": {
                        "sources": {
                          "type": "array",
                          "items": {}
                        },
                        "not_checked": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "note": {
                          "type": "string"
                        }
                      }
                    },
                    "source": {
                      "type": "string"
                    },
                    "read_ms": {
                      "type": "number"
                    },
                    "cached": {
                      "type": "boolean"
                    },
                    "live_read": {
                      "type": "boolean"
                    },
                    "paid": {
                      "type": "boolean"
                    },
                    "bucket": {
                      "type": "string",
                      "enum": [
                        "quick",
                        "deep"
                      ]
                    },
                    "settlement": {
                      "type": "object",
                      "properties": {
                        "network": {
                          "type": "string"
                        },
                        "transaction": {
                          "type": "string"
                        },
                        "payer": {
                          "type": [
                            "string",
                            "null"
                          ]
                        }
                      }
                    },
                    "disclaimer": {
                      "type": "string"
                    },
                    "data_age_s": {
                      "type": "number",
                      "description": "Age of the chain read in seconds. 0 means just read. Reads may be reused up to 8 minutes (token, deep) or 2 minutes (wallet)."
                    }
                  },
                  "required": [
                    "ok",
                    "level",
                    "paid",
                    "disclaimer"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad address, unsupported chain or scan type. Returned before any 402 quote, so no payment is signed for a request that cannot run. Not charged.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "const": false
                    },
                    "charged": {
                      "const": false
                    },
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ]
                    }
                  },
                  "required": [
                    "ok",
                    "error"
                  ]
                }
              }
            }
          },
          "401": {
            "description": "API-key requests only (monthly API plans, not switched on yet): the key is missing, malformed, unknown or revoked. Keyless x402 requests never get 401."
          },
          "402": {
            "description": "Payment required. The PAYMENT-REQUIRED header (base64 JSON, x402 v2) lists the exact amount, asset, network and payTo for each rail. The JSON body carries the same quote (price, x402Version, accepts) for clients that read only the body. Repeat the request with a PAYMENT-SIGNATURE header.",
            "headers": {
              "PAYMENT-REQUIRED": {
                "schema": {
                  "type": "string"
                },
                "description": "base64 JSON x402 v2 payment requirements"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "const": false
                    },
                    "price": {
                      "type": "object",
                      "properties": {
                        "usd": {
                          "type": "string"
                        },
                        "atomic": {
                          "type": "string"
                        },
                        "decimals": {
                          "type": "integer"
                        },
                        "asset": {
                          "type": "string"
                        }
                      }
                    },
                    "x402Version": {
                      "type": "integer"
                    },
                    "accepts": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "error": {
                      "type": "object"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "API-key requests only: the plan is not active (payment failed, paused or cancelled) or the scan type is not in the plan."
          },
          "409": {
            "description": "That payment was already used. Not charged again.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "const": false
                    },
                    "charged": {
                      "const": false
                    },
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ]
                    }
                  },
                  "required": [
                    "ok",
                    "error"
                  ]
                }
              }
            }
          },
          "429": {
            "description": "A spend limit was reached. Not charged. With an API key: per-second rate limit (rate_limited) or daily unique-scan quota reached (quota_exceeded); see Retry-After and X-Quota-* headers.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "const": false
                    },
                    "charged": {
                      "const": false
                    },
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ]
                    }
                  },
                  "required": [
                    "ok",
                    "error"
                  ]
                }
              }
            }
          },
          "502": {
            "description": "The read did not finish. Not charged. Try again.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "const": false
                    },
                    "charged": {
                      "const": false
                    },
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ]
                    }
                  },
                  "required": [
                    "ok",
                    "error"
                  ]
                }
              }
            }
          },
          "503": {
            "description": "That chain is not switched on, or scanning is closed. Refused before any charge.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "const": false
                    },
                    "charged": {
                      "const": false
                    },
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ]
                    }
                  },
                  "required": [
                    "ok",
                    "error"
                  ]
                }
              }
            }
          },
          "504": {
            "description": "A data source was too slow, so the read did not finish in time. Not charged. Try again in a few seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "const": false
                    },
                    "charged": {
                      "const": false
                    },
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ]
                    }
                  },
                  "required": [
                    "ok",
                    "error"
                  ]
                }
              }
            }
          }
        },
        "security": [
          {},
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ]
      }
    }
  },
  "externalDocs": {
    "description": "Developer docs",
    "url": "https://nodetrail.io/developers/"
  },
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key",
        "description": "Optional alternative to x402 payment for monthly API plans (coming soon, not switched on). Key format nt_<id>_<secret>. Quota: unique successful scans per UTC day; failed reads and same-day repeats are not counted. Without a key, the x402 402 flow applies unchanged."
      },
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "Same API key sent as Authorization: Bearer nt_<id>_<secret>. Optional alternative to x402 payment (coming soon, not switched on)."
      }
    }
  }
}
