{
  "openapi": "3.1.0",
  "info": {
    "title": "FeedPlumb Unified API",
    "version": "3.0.0",
    "summary": "Unified OpenAPI 3.1 specification for FeedPlumb portal, verification, sandbox, data, alerts, DocAnchor document time stamps, attestation, node monitoring, and analytics endpoints on the XDC Network.",
    "description": "Independent operational data, Merkle timestamping, EAS attestations, and developer tooling for the XDC Network (mainnet chainId 50 and Apothem testnet chainId 51). Unified credit weights: 0 credits (/verify/v1/*), 1 credit (DataQuery & MCP reads), 5 credits (one page of historical series), 100 credits (feed verdicts and RWA readings), 200 credits (DocAnchor), 500 credits (trade-document checks), 2,500 credits (AttestXDC). RouteQuote: 200 credits per venue quote that finds a route; the /v1/route reference rate is 0 credits.",
    "contact": {
      "name": "FeedPlumb",
      "url": "https://feedplumb.com/support/"
    },
    "license": {
      "name": "Proprietary / API Terms of Service",
      "url": "https://feedplumb.com/terms/"
    },
    "x-credit-weights": {
      "verify": 0,
      "dataQuery": 1,
      "historyPage": 5,
      "verdictAndRwa": 100,
      "docAnchor": 200,
      "routeQuote": 200,
      "tradeChecks": 500,
      "attestXdc": 2500
    }
  },
  "servers": [
    {
      "url": "https://feedplumb.com",
      "description": "Primary production host"
    },
    {
      "url": "https://www.feedplumb.app",
      "description": "DeFi, developer & Web3 wallet console"
    },
    {
      "url": "https://data.feedplumb.com",
      "description": "Public data boards & verification host"
    }
  ],
  "x-credit-weights": {
    "verify": {
      "credits": 0,
      "paths": [
        "/verify/v1/*"
      ],
      "description": "Public proof and receipt verification"
    },
    "dataRead": {
      "credits": 1,
      "paths": [
        "/data/v1/feeds",
        "/data/v1/feeds/{pair}",
        "/mcp"
      ],
      "description": "DataQuery & MCP reads"
    },
    "historyPage": {
      "credits": 5,
      "paths": [
        "/data/v1/feeds/{pair}/history",
        "/rwa/reserve-history"
      ],
      "description": "One page of historical series or reserve history (8-30 days: included in Builder, Pro and Protocol, or 25 credits per call on Free and Solo)"
    },
    "verdictAndRwa": {
      "credits": 100,
      "paths": [
        "/v1/{chain}/verdict/{address}",
        "/x402/v1/feed/{address}/verdict",
        "/x402/v1/reserve/{token}"
      ],
      "description": "Feed verdicts and RWA readings"
    },
    "docAnchor": {
      "credits": 200,
      "paths": [
        "/v1/notary/anchor",
        "/rwa/docanchor/register"
      ],
      "description": "DocAnchor document time stamp (on-chain anchoring is Coming soon)"
    },
    "routeQuote": {
      "credits": 200,
      "paths": [
        "/v1/route"
      ],
      "description": "RouteQuote: 200 credits per venue quote that finds a route (Coming soon); the /v1/route reference rate is 0 credits"
    },
    "tradeChecks": {
      "credits": 500,
      "paths": [
        "/apis/remittrace/iso20022",
        "/apis/lc-precheck/ucp600",
        "/rwa/iso20022/generate"
      ],
      "description": "Trade-document checks: RemitTrace, LC-Precheck and ISO 20022 generation (Coming soon)"
    },
    "attestXdc": {
      "credits": 2500,
      "paths": [
        "/v1/attest/issue",
        "/rwa/attestation"
      ],
      "description": "AttestXDC on-chain EAS attestation (Coming soon)"
    }
  },
  "x-plans": [
    {
      "id": "free",
      "name": "Free",
      "currency": "EUR",
      "priceInclVat": 0,
      "priceExclVat": 0,
      "monthlyCredits": 50000
    },
    {
      "id": "solo",
      "name": "Solo",
      "currency": "EUR",
      "priceInclVat": 14.99,
      "priceExclVat": 12.39,
      "monthlyCredits": 150000
    },
    {
      "id": "builder",
      "name": "Builder",
      "currency": "EUR",
      "priceInclVat": 39,
      "priceExclVat": 32.23,
      "monthlyCredits": 500000
    },
    {
      "id": "pro",
      "name": "Pro",
      "currency": "EUR",
      "priceInclVat": 119,
      "priceExclVat": 98.35,
      "monthlyCredits": 2000000
    },
    {
      "id": "protocol",
      "name": "Protocol",
      "currency": "EUR",
      "priceInclVat": 299,
      "priceExclVat": 247.11,
      "monthlyCredits": 6000000
    }
  ],
  "components": {
    "securitySchemes": {
      "ApiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key",
        "description": "Unified FeedPlumb API key (fpk_live_... or fpk_test_...)"
      },
      "X402Payment": {
        "type": "apiKey",
        "in": "header",
        "name": "PAYMENT-SIGNATURE",
        "description": "Coming soon: x402 v2 EIP-3009 USDC transferWithAuthorization payment header on XDC (chainId 50 or 51)"
      },
      "FeedPlumbKey": {
        "type": "apiKey",
        "in": "header",
        "name": "X-FeedPlumb-Key",
        "description": "Unified API key (fpk_live_... or fpk_test_...)"
      },
      "PortalSession": {
        "type": "http",
        "scheme": "bearer",
        "description": "Portal session token (fpsess_...) from magic-link sign-in"
      }
    }
  },
  "paths": {
    "/health": {
      "get": {
        "summary": "Gateway & SQLite WAL health check",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/openapi.json": {
      "get": {
        "summary": "OpenAPI 3.1 specification",
        "responses": {
          "200": {
            "description": "OpenAPI JSON"
          }
        }
      }
    },
    "/v1/openapi.json": {
      "get": {
        "summary": "OpenAPI 3.1 specification (0 credits)",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "OpenAPI JSON"
          }
        }
      }
    },
    "/v1/chains": {
      "get": {
        "tags": [
          "watch"
        ],
        "summary": "Chains FeedPlumb serves (registry: id, chainId, CAIP-2, status live|preview|planned, oracles, offerings) (0 credits)",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Chain list"
          }
        }
      }
    },
    "/v1/{chain}/watch/summary": {
      "get": {
        "tags": [
          "watch"
        ],
        "summary": "Feed Watch: per-provider counts of fresh, stale and reverting oracle feeds on one chain, last incident (no key, 0 credits)",
        "x-credits": 0,
        "parameters": [
          {
            "name": "chain",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "xdc",
                "base"
              ]
            },
            "description": "Chain id from GET /v1/chains"
          }
        ],
        "responses": {
          "200": {
            "description": "Chain summary"
          },
          "404": {
            "description": "Unknown chain"
          }
        }
      }
    },
    "/v1/{chain}/watch/feeds": {
      "get": {
        "tags": [
          "watch"
        ],
        "summary": "Feed Watch: every watched feed on one chain with answer, age, heartbeat, status, reference deviation, aggregator and owner; filters ?status= ?kind=price|por|nav ?provider= (no key, 0 credits)",
        "description": "Each feed also carries `config` and `configFingerprint`. `config` is the last on-chain configuration reading of the feed's aggregator: aggregatorOwner, oracleSet (comma-separated oracle addresses), ocrConfig (Base: configuration count and digest), roundConfig (XDC: Flux round settings), oracleCount. `configFingerprint` is a short hash of aggregator, owner, these fields, heartbeat and deviation threshold; it changes when any of them changes. Both are null until the first reading.",
        "x-credits": 0,
        "parameters": [
          {
            "name": "chain",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "xdc",
                "base"
              ]
            },
            "description": "Chain id from GET /v1/chains"
          }
        ],
        "responses": {
          "200": {
            "description": "Feed list"
          }
        }
      }
    },
    "/v1/{chain}/watch/feeds/{address}": {
      "get": {
        "tags": [
          "watch"
        ],
        "summary": "Feed Watch: one feed with its last rounds, incidents and aggregator/owner changes (no key, 0 credits)",
        "x-credits": 0,
        "parameters": [
          {
            "name": "chain",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "xdc",
                "base"
              ]
            },
            "description": "Chain id from GET /v1/chains"
          },
          {
            "name": "address",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            },
            "description": "Feed proxy address"
          }
        ],
        "responses": {
          "200": {
            "description": "Feed detail"
          },
          "404": {
            "description": "Feed not watched"
          }
        }
      }
    },
    "/v1/watch/incidents": {
      "get": {
        "tags": [
          "watch"
        ],
        "summary": "Feed Watch incidents across chains (no key, 0 credits). RSS: /v1/watch/incidents.rss",
        "description": "Kinds: stale, reverting, deviation (reference price gap), owner_change (feed proxy owner), aggregator_owner_change, oracle_set_change (oracles that may report), ocr_config_change (OCR configuration digest; Base), round_config_change (Flux round settings; XDC), heartbeat_change and deviation_change (from the published Chainlink directory, an off-chain source), config_change (older entries), reserve_drop (reserve feed answer down 5 % or more in one round), nav_move (NAV answer moved 2 % or more in one round). Configuration is read on chain about once an hour; the matching on-chain event is looked up in the last 5,000 blocks where the RPC allows it.",
        "parameters": [
          {
            "name": "chain",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "xdc",
                "base"
              ]
            },
            "description": "Chain id from GET /v1/chains"
          },
          {
            "name": "kind",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "stale",
                "reverting",
                "deviation",
                "config_change",
                "owner_change",
                "aggregator_owner_change",
                "oracle_set_change",
                "ocr_config_change",
                "round_config_change",
                "heartbeat_change",
                "deviation_change",
                "reserve_drop",
                "nav_move"
              ]
            }
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000
            }
          }
        ],
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Incident list"
          }
        }
      }
    },
    "/v1/{chain}/verdict/{address}": {
      "get": {
        "tags": [
          "watch"
        ],
        "summary": "Verdict API: ok, caution or avoid for one feed before you read it, with reasons, uptime and open incidents, as a signed feedplumb.record/v1 envelope (100 credits; nothing debited without a record)",
        "x-credits": 100,
        "security": [
          {
            "ApiKeyHeader": []
          },
          {
            "FeedPlumbKey": []
          }
        ],
        "parameters": [
          {
            "name": "chain",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "xdc",
                "base"
              ]
            },
            "description": "Chain id from GET /v1/chains"
          },
          {
            "name": "address",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            },
            "description": "Feed proxy address"
          }
        ],
        "responses": {
          "200": {
            "description": "Signed verdict record"
          },
          "404": {
            "description": "Feed not watched"
          }
        }
      }
    },
    "/v1/{chain}/verdict/{address}/public": {
      "get": {
        "tags": [
          "watch"
        ],
        "summary": "Public verdict, no key: the same ok, caution or avoid verdict for one feed, unsigned, 0 credits, 20 calls per day per IP (429 daily_limit with retry-after), cached for 60 seconds",
        "x-credits": 0,
        "parameters": [
          {
            "name": "chain",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "xdc",
                "base"
              ]
            },
            "description": "Chain id from GET /v1/chains"
          },
          {
            "name": "address",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            },
            "description": "Feed proxy address"
          }
        ],
        "responses": {
          "200": {
            "description": "Unsigned verdict"
          },
          "404": {
            "description": "Feed not watched"
          },
          "429": {
            "description": "Daily limit reached (daily_limit)"
          }
        }
      }
    },
    "/v1/{chain}/evidence": {
      "get": {
        "tags": [
          "watch"
        ],
        "summary": "Evidence Report: monthly per-feed record of freshness, max age, incidents and config changes (?feeds=0x..,0x..&month=YYYY-MM), signed feedplumb.record/v1. Included in Pro and Protocol; otherwise 1,000,000 credits per report",
        "x-credits": 1000000,
        "security": [
          {
            "ApiKeyHeader": []
          },
          {
            "FeedPlumbKey": []
          }
        ],
        "parameters": [
          {
            "name": "chain",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "xdc",
                "base"
              ]
            },
            "description": "Chain id from GET /v1/chains"
          }
        ],
        "responses": {
          "200": {
            "description": "Signed evidence report"
          },
          "403": {
            "description": "Too many feeds for the plan"
          }
        }
      }
    },
    "/v1/watch/uptime": {
      "get": {
        "tags": [
          "watch"
        ],
        "summary": "Feed uptime: share of scans in which each feed was fresh over 7, 30 and 90 days, days observed, and incident counts; with ?feed= also the daily rows and the incident history (no key, 0 credits)",
        "description": "Scans run about every 2 minutes. Fresh means the age is within the heartbeat plus 600 seconds. A window only counts days FeedPlumb observed; daysObserved says how many (observation started on 20 November 2026).",
        "x-credits": 0,
        "parameters": [
          {
            "name": "chain",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "xdc",
                "base"
              ]
            },
            "description": "Chain id from GET /v1/chains"
          },
          {
            "name": "feed",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            },
            "description": "Feed proxy address (optional)"
          }
        ],
        "responses": {
          "200": {
            "description": "Uptime per feed"
          },
          "404": {
            "description": "Unknown chain or feed"
          }
        }
      }
    },
    "/v1/watch/chain-health": {
      "get": {
        "tags": [
          "watch"
        ],
        "summary": "Chain health from the last 20 blocks: newest block and its age, average and longest block interval, gas price, base fee, gas used and transactions per block, status producing, slow or halted_or_lagging (no key, 0 credits, cached 30 seconds)",
        "x-credits": 0,
        "parameters": [
          {
            "name": "chain",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "xdc",
                "base"
              ]
            },
            "description": "Chain id from GET /v1/chains"
          }
        ],
        "responses": {
          "200": {
            "description": "Chain health"
          },
          "503": {
            "description": "RPC not reachable"
          }
        }
      }
    },
    "/v1/tools/approvals": {
      "get": {
        "tags": [
          "tools"
        ],
        "summary": "Token approval checker, read-only: current ERC-20 allowances an address has given (no key, 0 credits, 20 checks per day per IP)",
        "description": "Checks the tokens of the lending markets FeedPlumb maps on the chain. Spenders checked: those lending contracts, Permit2, and any spender in the address's Approval events within the recent log window shown in checked.logWindow. Older approvals to other spenders are not found; NFT operator approvals are not checked. FeedPlumb sends and signs nothing; revoke.href links to an external site.",
        "x-credits": 0,
        "parameters": [
          {
            "name": "chain",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "xdc",
                "base"
              ]
            },
            "description": "Chain id from GET /v1/chains"
          },
          {
            "name": "owner",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            },
            "description": "Address to check"
          }
        ],
        "responses": {
          "200": {
            "description": "Allowances found"
          },
          "400": {
            "description": "Bad chain or address"
          },
          "429": {
            "description": "Daily limit reached (daily_limit)"
          }
        }
      }
    },
    "/v1/tools/verification": {
      "get": {
        "tags": [
          "tools"
        ],
        "summary": "Contract verification lookup: whether the address has code and whether Sourcify has verified source (exact or partial match, contract name, compiler), with a link to the explorer (no key, 0 credits, 100 per day per IP)",
        "x-credits": 0,
        "parameters": [
          {
            "name": "chain",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "xdc",
                "base"
              ]
            },
            "description": "Chain id from GET /v1/chains"
          },
          {
            "name": "address",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            },
            "description": "Contract address"
          }
        ],
        "responses": {
          "200": {
            "description": "Verification status"
          },
          "429": {
            "description": "Daily limit reached (daily_limit)"
          }
        }
      }
    },
    "/v1/risk/markets": {
      "get": {
        "tags": [
          "watch"
        ],
        "summary": "Lending-market oracle monitor: lending markets on one chain with the oracle feeds their price sources read, each feed's age and status, and the gap to reference prices (100 credits, unsigned live reading)",
        "description": "Markets: Base Aave v3, Moonwell, Compound v3 (USDC, WETH, USDbC, AERO, USDS); XDC Fathom Lending. Price adapters are resolved one level. Reference prices: on-chain Pyth when at most one hour old, and DEX pools on Uniswap v3 and Aerodrome Slipstream holding at least USD 50,000 of the quote token, or Aerodrome v2 volatile pools holding at least USD 250,000. Each row has alertTarget `<chain>:<protocol>:<0xasset>` for alert rules (staleness_sec, deviation_bps); each such target counts as one watched feed against the plan limit. Fresh and stale use the feed's heartbeat plus 600 seconds. time_not_exposed is a per-feed status (the source reports the current time, not its upstream round time), not a market-level filter. It reports oracle feed readings only; it does not assess positions or predict liquidations. This is a monitoring reading, not advice.",
        "x-credits": 100,
        "security": [
          {
            "ApiKeyHeader": []
          },
          {
            "FeedPlumbKey": []
          }
        ],
        "parameters": [
          {
            "name": "chain",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "xdc",
                "base"
              ]
            },
            "description": "Chain id from GET /v1/chains"
          },
          {
            "name": "protocol",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "e.g. aave-v3, moonwell, compound-v3-usdc, fathom-lending"
          },
          {
            "name": "asset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            },
            "description": "Token address"
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "fresh",
                "stale",
                "age_only",
                "partly_age_only",
                "reverting",
                "no_round_data"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Markets"
          },
          "400": {
            "description": "Bad filter (not charged)"
          },
          "404": {
            "description": "Unknown chain or no markets mapped"
          }
        }
      }
    },
    "/v1/risk/dependencies": {
      "get": {
        "tags": [
          "watch"
        ],
        "summary": "Feed dependency map: which oracle feeds a contract reads, how each was found, and each feed's health and verdict (100 credits, unsigned live reading)",
        "description": "Methods: proxy resolution (EIP-1967, beacon, EIP-1167), address constants in the code, plain address values in storage slots 0 to 63, one level of referenced contracts, and lending contracts FeedPlumb maps. Call traces are tried but public RPCs usually refuse them; `methods` reports what ran. Feeds passed as call arguments or kept in mappings are not found, and only feeds FeedPlumb knows can be matched.",
        "x-credits": 100,
        "security": [
          {
            "ApiKeyHeader": []
          },
          {
            "FeedPlumbKey": []
          }
        ],
        "parameters": [
          {
            "name": "chain",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "xdc",
                "base"
              ]
            },
            "description": "Chain id from GET /v1/chains"
          },
          {
            "name": "address",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            },
            "description": "Contract address"
          }
        ],
        "responses": {
          "200": {
            "description": "Dependency map"
          },
          "400": {
            "description": "Bad address (not charged)"
          }
        }
      }
    },
    "/v1/risk/dependencies/preview": {
      "get": {
        "tags": [
          "watch"
        ],
        "summary": "Dependency map preview, no key: number of feeds found and the first three, without health (0 credits, 5 per day per IP)",
        "x-credits": 0,
        "parameters": [
          {
            "name": "chain",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "xdc",
                "base"
              ]
            },
            "description": "Chain id from GET /v1/chains"
          },
          {
            "name": "address",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            },
            "description": "Contract address"
          }
        ],
        "responses": {
          "200": {
            "description": "Preview"
          },
          "429": {
            "description": "Daily limit reached (daily_limit)"
          }
        }
      }
    },
    "/v1/feed-reports": {
      "get": {
        "tags": [
          "watch"
        ],
        "summary": "Reserve & NAV feed report: monthly record for one reserve or NAV feed from FeedPlumb's own readings (first, last, min and max value, change, freshness, days observed, incidents, config changes), as a feedplumb.record/v1 envelope. Included in Pro and Protocol; otherwise 100,000 credits",
        "description": "FeedPlumb does not audit the reserves or the assets behind them; the report lists the on-chain values the feed published and how often FeedPlumb read them. Records have kind feed-report and are marked unsigned: true until the signing key is installed; the digest can be checked with POST /verify/v1/record.",
        "x-credits": 100000,
        "security": [
          {
            "ApiKeyHeader": []
          },
          {
            "FeedPlumbKey": []
          }
        ],
        "parameters": [
          {
            "name": "chain",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "xdc",
                "base"
              ]
            },
            "description": "Chain id from GET /v1/chains"
          },
          {
            "name": "feed",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            },
            "description": "Reserve or NAV feed address"
          },
          {
            "name": "month",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-(0[1-9]|1[0-2])$"
            },
            "description": "YYYY-MM (default: current month)"
          }
        ],
        "responses": {
          "200": {
            "description": "Feed report record"
          },
          "400": {
            "description": "Not a reserve or NAV feed, or bad month (not charged)"
          },
          "404": {
            "description": "Feed not watched"
          }
        }
      }
    },
    "/v1/keys": {
      "get": {
        "tags": [
          "watch"
        ],
        "summary": "Public Ed25519 keys that sign FeedPlumb records (0 credits)",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Key list"
          }
        }
      }
    },
    "/verify/v1/record": {
      "post": {
        "tags": [
          "watch"
        ],
        "summary": "Check a feedplumb.record/v1 envelope: digest and signature (0 credits)",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Valid"
          },
          "400": {
            "description": "Digest or signature does not match"
          }
        }
      }
    },
    "/v1/feeds": {
      "get": {
        "tags": [
          "data"
        ],
        "summary": "Live 247-feed XDC & Plugin oracle catalog (with optional ?pair=, ?status=, ?limit= filters)",
        "x-credits": 1,
        "security": [
          {
            "ApiKeyHeader": []
          },
          {
            "FeedPlumbKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Live feed catalog"
          }
        }
      }
    },
    "/v1/feeds/{pair}": {
      "get": {
        "tags": [
          "data"
        ],
        "summary": "Single feed quote & freshness status by pair (e.g. XDC-USD, PLI-USDT)",
        "x-credits": 1,
        "security": [
          {
            "ApiKeyHeader": []
          },
          {
            "FeedPlumbKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Single feed snapshot"
          }
        }
      }
    },
    "/v1/route": {
      "get": {
        "tags": [
          "route"
        ],
        "summary": "Plugin oracle reference rate for a pair; per-venue DEX quotes (XSwap, IceCreamSwap) are coming soon, so this call is 0 credits for now (Solo+)",
        "x-credits": 0,
        "security": [
          {
            "ApiKeyHeader": []
          },
          {
            "FeedPlumbKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Swap route quote"
          }
        }
      }
    },
    "/v1/ecosystem": {
      "get": {
        "tags": [
          "ecosystem"
        ],
        "summary": "6-category XDC Ecosystem coverage catalog (0 credits)",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "XDC Ecosystem catalog"
          }
        }
      }
    },
    "/apis/invoicematch/create": {
      "post": {
        "tags": [
          "invoicematch"
        ],
        "summary": "Not offered yet: create non-custodial XDC USDC invoice with ISO 20022 SCOR reference (Solo+)",
        "x-credits": 500,
        "security": [
          {
            "ApiKeyHeader": []
          },
          {
            "FeedPlumbKey": []
          }
        ],
        "responses": {
          "201": {
            "description": "Invoice created"
          }
        }
      }
    },
    "/portal/v1/auth/signup": {
      "post": {
        "tags": [
          "portal"
        ],
        "summary": "Register or update B2C/B2B account",
        "x-credits": 0,
        "responses": {
          "201": {
            "description": "Account created"
          }
        }
      }
    },
    "/portal/v1/auth/magic-link": {
      "post": {
        "tags": [
          "portal"
        ],
        "summary": "Request email sign-in link (B2C/B2B onboarding & role assignment)",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Magic link issued (dry-run token returned in test mode)"
          }
        }
      }
    },
    "/portal/v1/auth/verify": {
      "post": {
        "tags": [
          "portal"
        ],
        "summary": "Verify magic link token and issue session",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Session issued"
          }
        }
      }
    },
    "/portal/v1/account": {
      "get": {
        "tags": [
          "portal"
        ],
        "summary": "Read current account profile, team members, role (owner/admin/developer/billing), B2C start-now consent status, and monthly spending cap",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Account profile"
          }
        }
      },
      "post": {
        "tags": [
          "portal"
        ],
        "summary": "Update account onboarding type (B2C/B2B), start-now consent (14-day withdrawal right stays), team role, or spending cap",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Updated account profile"
          }
        }
      },
      "patch": {
        "summary": "Update account profile, EU VAT, or spend limits",
        "responses": {
          "200": {
            "description": "Account updated"
          }
        }
      }
    },
    "/portal/v1/account/team": {
      "get": {
        "tags": [
          "portal"
        ],
        "summary": "List team members and roles",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Team members"
          }
        }
      },
      "post": {
        "tags": [
          "portal"
        ],
        "summary": "Add or update team member (owner/admin/developer/billing)",
        "x-credits": 0,
        "responses": {
          "201": {
            "description": "Member added"
          }
        }
      },
      "delete": {
        "summary": "P5.4 · Remove B2B team member seat from workspace",
        "responses": {
          "200": {
            "description": "Member removed"
          }
        }
      }
    },
    "/portal/v1/account/withdraw": {
      "post": {
        "tags": [
          "portal"
        ],
        "summary": "Exercise B2C 14-day statutory withdrawal and pro-rata credit refund",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Withdrawn"
          }
        }
      }
    },
    "/portal/v1/keys": {
      "get": {
        "tags": [
          "portal"
        ],
        "summary": "List unified API keys (fpk_live_... and fpk_test_...)",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "API keys list"
          }
        }
      },
      "post": {
        "tags": [
          "portal"
        ],
        "summary": "Issue an API key (label, live or test, calls a minute up to your plan limit). Access follows your plan; per-key scopes and spending limits: Coming soon",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Key operation result"
          }
        }
      }
    },
    "/portal/v1/keys/{id}/rotate": {
      "post": {
        "tags": [
          "portal"
        ],
        "summary": "Atomically revoke old key and issue replacement",
        "x-credits": 0,
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Key rotated"
          }
        }
      }
    },
    "/portal/v1/keys/{id}/revoke": {
      "post": {
        "tags": [
          "portal"
        ],
        "summary": "Revoke API key immediately",
        "x-credits": 0,
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Key revoked"
          }
        }
      }
    },
    "/portal/v1/keys/x402": {
      "post": {
        "tags": [
          "portal"
        ],
        "summary": "Coming soon: per-key x402 controls to turn pay per request on or off and set a monthly cap in credits (owner or admin)",
        "x-credits": 0,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "keyId"
                ],
                "properties": {
                  "keyId": {
                    "type": "string"
                  },
                  "payPerRequest": {
                    "type": "boolean"
                  },
                  "monthlyCapCredits": {
                    "type": [
                      "integer",
                      "null"
                    ],
                    "minimum": 0,
                    "maximum": 100000000,
                    "description": "null = no cap; credits in the x100 unit (a basic read is 1 credit)"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Updated controls with the credits used this month on x402 routes"
          },
          "400": {
            "description": "Invalid settings or revoked key"
          },
          "404": {
            "description": "API key not found in this account"
          }
        }
      }
    },
    "/portal/v1/usage": {
      "get": {
        "tags": [
          "portal"
        ],
        "summary": "Credit balance, hourly calls and credits per key and endpoint for one UTC month, and the last 100 calls with status code and latency",
        "x-credits": 0,
        "parameters": [
          {
            "name": "period",
            "in": "query",
            "required": false,
            "description": "UTC month as YYYY-MM; defaults to the current month",
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-(0[1-9]|1[0-2])$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Usage telemetry"
          }
        }
      }
    },
    "/portal/v1/billing/plans": {
      "get": {
        "tags": [
          "portal"
        ],
        "summary": "List subscription plans (Free to Protocol, VAT inclusive and exclusive) and the credit slider spec",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Plans and the credit slider (creditSlider)"
          }
        }
      }
    },
    "/portal/v1/credits/slider": {
      "get": {
        "tags": [
          "portal"
        ],
        "summary": "Credit slider spec: allowed credit counts (500, 800, then 1,000 to 100,000 in steps of 500), the price curve and its status",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "creditSlider: status (on_sale or coming_soon), currency, pricesIncludeVat, minCredits, maxCredits, steps, curve, fixedTotalsCents, floorFromCredits, aboveMax.contact, validityMonths {consumer, business} for the requesting site, from the credit policy"
          }
        }
      }
    },
    "/portal/v1/credits/quote": {
      "get": {
        "tags": [
          "portal"
        ],
        "summary": "Quote one credit slider step (total incl. VAT in cents and the rate per 100,000 credits). Server-side quote used by Stripe Checkout.",
        "x-credits": 0,
        "parameters": [
          {
            "name": "credits",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 50000,
              "maximum": 10000000
            },
            "description": "A slider step: 50,000, 80,000, or 100,000 to 10,000,000 in steps of 50,000"
          }
        ],
        "responses": {
          "200": {
            "description": "quote: credits, totalCents, ratePerUnitCents (per rateUnitCredits = 100,000 credits), currency"
          },
          "400": {
            "description": "invalid_credits (not a slider step), or contact_us above 10,000,000 credits (mailto:support@feedplumb.com)"
          }
        }
      }
    },
    "/portal/v1/billing/checkout": {
      "post": {
        "tags": [
          "portal"
        ],
        "summary": "Create sequential FP-2026-xxxxx invoice and checkout (Card or SEPA; USDC, XDC and PLI on XDC are not offered yet)",
        "x-credits": 0,
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "itemType": {
                    "type": "string",
                    "enum": [
                      "plan",
                      "credits"
                    ],
                    "default": "plan",
                    "description": "plan: a workspace subscription. credits: a credit-slider purchase (itemType pack still returns 410 credit_packs_replaced). PLI (pli_xdc) is accepted only for credits, not for plans."
                  },
                  "itemCode": {
                    "type": "string",
                    "default": "solo",
                    "description": "Plan key (solo, builder, pro, protocol) when itemType is plan"
                  },
                  "credits": {
                    "type": "integer",
                    "description": "Slider credit count when itemType is credits or kind is credits. Must be a published slider step."
                  },
                  "paymentMethod": {
                    "type": "string",
                    "enum": [
                      "card",
                      "sepa",
                      "usdc_xdc",
                      "xdc_native",
                      "pli_xdc"
                    ],
                    "default": "card"
                  },
                  "startNowConsent": {
                    "type": "boolean",
                    "description": "The buyer ticked the separate, unticked box: \"Start my plan now. I understand that if I cancel within 14 days, I pay only for the days or credits I've used.\" Only checked when the server runs with FP_BILLING_CHECKOUT_START_NOW=1: then it must be exactly true (otherwise 400 start_now_consent_required), the consent is logged with a timestamp before the invoice is created, and the invoice line item carries startNowConsentAt. While that flag is off (the default) the field is ignored."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Checkout and invoice created. For usdc_xdc, usdcQuote carries the EUR gross converted at the EUR/USD rate of the quote (ECB reference rate; documented fallback when it is unavailable or older than 48h), rounded up to the cent, a unique reference, the rate source and time, and expiresAt (quote valid for 15 minutes). For xdc_native (plans and credits) and pli_xdc (credits and other one-off services only, never plans), off unless FP_XDC_PLI_CHECKOUT_ENABLED=true, usdcQuote / cryptoQuote carries the EUR gross converted at the live FeedPlumb/Plugin feed rate, plus a short validity window (default 5 minutes) and a slippage buffer (default 2%) baked into the required token amount."
          },
          "400": {
            "description": "start_now_consent_required (only when FP_BILLING_CHECKOUT_START_NOW=1 and startNowConsent is not true), token_not_allowed_for_plan (pli_xdc is not accepted for plan purchases), invalid_credits or amount_mismatch for credit-slider checkout, or an invalid item"
          },
          "503": {
            "description": "usdc_xdc: pay_to_not_configured (error treasury_not_configured when the region × plan map and the legacy treasury are both unset), chain_rpc_unavailable or fx_rate_unavailable. xdc_native / pli_xdc: pay_to_not_configured, pay_to_invalid, pay_to_map_invalid, xdc_pli_checkout_disabled or price_feed_unavailable. No invoice is created when no receiving address resolves."
          }
        }
      }
    },
    "/portal/v1/billing/invoices": {
      "get": {
        "tags": [
          "portal"
        ],
        "summary": "List account tax invoices",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Invoices"
          }
        }
      }
    },
    "/portal/v1/billing/invoices/{id}": {
      "get": {
        "tags": [
          "portal"
        ],
        "summary": "Get invoice JSON or printable HTML (?format=html)",
        "x-credits": 0,
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Invoice"
          }
        }
      }
    },
    "/portal/v1/billing/webhooks/checkout": {
      "post": {
        "tags": [
          "portal"
        ],
        "summary": "Card/SEPA checkout webhook handler (configurable/dry-run)",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Processed"
          }
        }
      }
    },
    "/portal/v1/billing/invoices/{id}/verify-usdc": {
      "post": {
        "tags": [
          "portal"
        ],
        "summary": "Not offered yet: verify non-custodial USDC on XDC payment and settle invoice",
        "description": "Settles only a mined, successful, sufficiently confirmed native USDC transfer of at least the quoted amount to the receiving address stored on the invoice quote, sent from a wallet linked to this account (POST /portal/v1/billing/usdc-wallets) within the 15-minute quote window. Each txHash settles at most one receipt across all settlement routes. Other payments to that address are recorded for manual review and never credited automatically. When offered, a USDC plan payment will prepay one monthly period from the block time. For XDC and PLI invoices use POST .../verify-crypto.",
        "x-credits": 0,
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Settled"
          },
          "202": {
            "description": "manual_review: payment received but not credited automatically (wallet not linked to this account, or outside the quote window)"
          },
          "402": {
            "description": "pending_onchain or pending_confirmations: nothing booked yet"
          },
          "409": {
            "description": "Rejected: amount below quote, wrong recipient, failed tx, tx_replay, or no current quote"
          }
        }
      }
    },
    "/portal/v1/wallet/watch": {
      "get": {
        "tags": [
          "watch"
        ],
        "summary": "Wallet-owned Feed Watch list (?wallet=0x..). Sign in with the wallet first: GET /portal/v1/auth/siwe?purpose=watch gives a read-only message (no transaction, no funds); send it as x-siwe-message and x-siwe-signature, then use the returned walletProofToken as x-wallet-proof for 12 hours. 0 credits",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Targets on the list and the limit"
          },
          "401": {
            "description": "Wallet sign-in required"
          }
        }
      },
      "post": {
        "tags": [
          "watch"
        ],
        "summary": "Add a target <chain>:<0xaddress> to the wallet's watch list (up to 3, as on Free). 0 credits",
        "x-credits": 0,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "wallet",
                  "target"
                ],
                "properties": {
                  "wallet": {
                    "type": "string"
                  },
                  "target": {
                    "type": "string",
                    "pattern": "^[a-z][a-z0-9-]{1,23}:0x[0-9a-fA-F]{40}$"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Added"
          },
          "401": {
            "description": "Wallet sign-in required"
          },
          "403": {
            "description": "too_many_feeds"
          }
        }
      },
      "delete": {
        "tags": [
          "watch"
        ],
        "summary": "Remove a target from the wallet's watch list (?wallet=0x..&target=<chain>:<0xaddress>). 0 credits",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Removed"
          },
          "404": {
            "description": "Not on the list"
          }
        }
      }
    },
    "/portal/v1/billing/usdc-wallets": {
      "get": {
        "tags": [
          "portal"
        ],
        "summary": "Not offered yet: list wallets linked to this account for USDC invoice payments",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Linked wallets"
          }
        }
      },
      "post": {
        "tags": [
          "portal"
        ],
        "summary": "Not offered yet: link a wallet to this account for USDC invoice payments (requires proof of control: wallet proof or SIWE headers)",
        "x-credits": 0,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "wallet"
                ],
                "properties": {
                  "wallet": {
                    "type": "string",
                    "description": "0x address"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Linked"
          },
          "403": {
            "description": "wallet_proof_required"
          },
          "409": {
            "description": "wallet_bound_elsewhere"
          }
        }
      }
    },
    "/portal/v1/billing/invoices/{id}/verify-crypto": {
      "post": {
        "tags": [
          "portal"
        ],
        "summary": "Not offered yet: verify a non-custodial USDC, native XDC or PLI payment on XDC and settle the invoice",
        "description": "Same checks as verify-usdc, for usdc_xdc, xdc_native and pli_xdc invoices: mined successful transfer of at least the quoted amount (XDC: native value; USDC/PLI: the quoted token contract) to the receiving address stored on the invoice quote, enough confirmations, sender wallet linked to the account, and block time inside the quote window. XDC and PLI checkout is off unless FP_XDC_PLI_CHECKOUT_ENABLED=true. Each txHash settles at most one receipt. Other payments to that address are recorded for manual review and never credited automatically.",
        "x-credits": 0,
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Settled"
          },
          "202": {
            "description": "manual_review: payment received but not credited automatically (wallet not linked to this account, or outside the quote window)"
          },
          "402": {
            "description": "pending_onchain or pending_confirmations: nothing booked yet"
          },
          "409": {
            "description": "Rejected: amount below quote, wrong recipient or token, failed tx, tx_replay, or no current quote"
          },
          "503": {
            "description": "xdc_pli_checkout_disabled, pay_to_not_configured, or chain_rpc_unavailable"
          }
        }
      }
    },
    "/verify/v1/document/{sha256}": {
      "get": {
        "tags": [
          "verify"
        ],
        "summary": "Public 0-credit check of a SHA-256 document hash against a receipt (feedplumb-proof/v1); on-chain anchoring is Coming soon",
        "x-credits": 0,
        "parameters": [
          {
            "name": "sha256",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Proof envelope"
          }
        }
      }
    },
    "/verify/v1/bundle": {
      "post": {
        "tags": [
          "verify"
        ],
        "summary": "Public 0-credit offline/online verification of a feedplumb-proof/v1 JSON bundle",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Verification result"
          }
        }
      }
    },
    "/verify/v1/feed/{proxy}": {
      "get": {
        "tags": [
          "verify"
        ],
        "summary": "Public 0-credit verification of an XDC oracle feed round",
        "x-credits": 0,
        "parameters": [
          {
            "name": "proxy",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Feed proof envelope"
          }
        }
      }
    },
    "/verify/v1/rwa/health": {
      "get": {
        "tags": [
          "verify"
        ],
        "summary": "RWA feed health: per-feed status (ok / stale / reverting), age and last update from the hourly read-only check; stale: true when the check is missing or older than 3 h. No values, no reserve data. Alias: /rwa/health",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "feedplumb-rwa-health/v1 summary (available, stale, staleReason, checkedAt, checkAgeS, disclaimer, summary, feeds[])"
          }
        }
      }
    },
    "/verify/v1/rwa/{slug}": {
      "get": {
        "tags": [
          "verify"
        ],
        "summary": "Public 0-credit RWA oracle reading: feed freshness and on-chain identifiers, plus on-chain token supply (totalSupply) for CGO and USTY. FeedPlumb does not check issuer reserves; reserve ratio is always null",
        "x-credits": 0,
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "rwa_oracle_reading envelope (verified: false; onchainSupply with reserveRatio null and its reason)"
          },
          "404": {
            "description": "Unknown RWA asset"
          }
        }
      }
    },
    "/verify/v1/attestation/{uid}": {
      "get": {
        "tags": [
          "verify"
        ],
        "summary": "Coming soon · On-chain attestation lookup by UID (not anchored or indexed yet; returns 404 not_found with status coming_soon)",
        "x-status": "coming_soon",
        "x-credits": 0,
        "parameters": [
          {
            "name": "uid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "404": {
            "description": "Coming soon: no attestation can be found or verified yet"
          }
        }
      }
    },
    "/sandbox/v1/feeds": {
      "get": {
        "tags": [
          "sandbox"
        ],
        "summary": "Buyer sandbox deterministic feed list (XDC Apothem Chain 51)",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Sandbox feeds"
          }
        }
      }
    },
    "/sandbox/v1/apothem": {
      "get": {
        "tags": [
          "sandbox"
        ],
        "summary": "Apothem testnet contract directory and deterministic test vectors",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Apothem info"
          }
        }
      }
    },
    "/portal/v1/health": {
      "get": {
        "tags": [
          "portal"
        ],
        "summary": "Portal API gateway health check",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Gateway healthy"
          }
        }
      }
    },
    "/portal/v1/invoices": {
      "get": {
        "tags": [
          "portal"
        ],
        "summary": "List sequential FP-2026-xxxxx VAT invoices issued by FeedPlumb",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Invoice list"
          }
        }
      }
    },
    "/portal/v1/checkout": {
      "post": {
        "tags": [
          "portal"
        ],
        "summary": "Initiate Card or SEPA checkout session (USDC on XDC is not offered yet; dry-run safe when live credentials are absent)",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Checkout session and pro-forma invoice"
          }
        }
      }
    },
    "/portal/v1/receipts": {
      "get": {
        "tags": [
          "portal"
        ],
        "summary": "Coming soon: inspect x402 v2 AgentReceipts and daily Merkle batch anchors",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "AgentReceipts list"
          }
        }
      }
    },
    "/portal/v1/alerts/{id}": {
      "delete": {
        "tags": [
          "portal"
        ],
        "summary": "Delete one webhook or alert endpoint belonging to the signed-in account. Frees the endpoint slot. Settings are erased within 30 days.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Endpoint removed"
          },
          "401": {
            "description": "Authentication required"
          },
          "404": {
            "description": "No endpoint with this id on the signed-in account"
          }
        }
      }
    },
    "/portal/v1/alerts": {
      "get": {
        "tags": [
          "portal"
        ],
        "summary": "List self-serve NodeAlert and EventHook watch rules and delivery channels",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Configured alert rules"
          }
        }
      },
      "post": {
        "tags": [
          "portal"
        ],
        "summary": "Create NodeAlert / EventHook alert rules (webhook rules send signed deliveries through the EventHook API) or send a test-fire (webhook: signed request to your endpoint; email: your own verified address)",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Alert rule saved or test-fired"
          }
        }
      }
    },
    "/portal/v1/tools/{tool}": {
      "get": {
        "tags": [
          "portal"
        ],
        "summary": "Read tool state (rwa-sla-reports, nodealert, rpcwatch, reward-statement, snapshotdesk, addressfacts, pegwatch, meterkit, docanchor-archive, tax-export, invoice-match, task-runner, subnet-ops, attesthub, gas-sponsor, node-host, feed-relay, remittrace, lc-precheck)",
        "parameters": [
          {
            "name": "tool",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Tool dataset and status"
          }
        }
      },
      "post": {
        "tags": [
          "portal"
        ],
        "summary": "Run a tool action or simulation",
        "parameters": [
          {
            "name": "tool",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Tool execution result"
          }
        }
      }
    },
    "/verify/v1/health": {
      "get": {
        "tags": [
          "verify"
        ],
        "summary": "Verification service health check",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Healthy"
          }
        }
      }
    },
    "/verify/v1/proof": {
      "post": {
        "tags": [
          "verify"
        ],
        "summary": "Verify a feedplumb-proof/v1 Merkle proof bundle or SHA-256 leaf receipt (0 credits)",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Verification verdict"
          }
        }
      }
    },
    "/verify/v1/receipt/{id}": {
      "get": {
        "tags": [
          "verify"
        ],
        "summary": "Verify an x402 v2 AgentReceipt (Coming soon) or a DocAnchor receipt by ID (0 credits)",
        "x-credits": 0,
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Receipt verification details"
          }
        }
      }
    },
    "/sandbox/v1/health": {
      "get": {
        "tags": [
          "sandbox"
        ],
        "summary": "Buyer Sandbox health check",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Healthy"
          }
        }
      }
    },
    "/sandbox/v1/execute": {
      "post": {
        "tags": [
          "sandbox"
        ],
        "summary": "Execute Buyer Sandbox call in deterministic Mock mode or XDC Apothem (chainId 51) mode across DataQuery, EventHook, DocAnchor, AttestXDC, and x402 v2 headers",
        "responses": {
          "200": {
            "description": "Sandbox execution trace and receipt"
          }
        }
      }
    },
    "/data/health": {
      "get": {
        "tags": [
          "data"
        ],
        "summary": "DataQuery API health check",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Healthy"
          }
        }
      }
    },
    "/data/pricing": {
      "get": {
        "tags": [
          "data"
        ],
        "summary": "Subscription plans and unified endpoint credit weights",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Pricing and credit weights JSON"
          }
        }
      }
    },
    "/data/v1/feeds": {
      "get": {
        "tags": [
          "data"
        ],
        "summary": "List Plugin price feeds on XDC mainnet (1 credit)",
        "x-credits": 1,
        "security": [
          {
            "ApiKeyHeader": []
          },
          {
            "X402Payment": []
          }
        ],
        "responses": {
          "200": {
            "description": "Feed list"
          }
        }
      }
    },
    "/data/v1/feeds/{pair}/history": {
      "get": {
        "tags": [
          "data"
        ],
        "summary": "Historical feed rounds and series (5 credits per page; 25 for 8-30 days without the 30-day history add-on)",
        "x-credits": 5,
        "parameters": [
          {
            "name": "pair",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Historical series"
          }
        }
      }
    },
    "/data/v1/route": {
      "get": {
        "tags": [
          "data"
        ],
        "summary": "RouteQuote on XDC: best route across XSwap, Oku and Curve from read-only eth_call quotes at a stated block (200 credits; no route found costs 0). Query: tokenIn, tokenOut, amount or amountIn",
        "x-credits": 200,
        "responses": {
          "200": {
            "description": "Route quote"
          }
        }
      }
    },
    "/notify/health": {
      "get": {
        "tags": [
          "notify"
        ],
        "summary": "EventHook webhook service health check",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Healthy"
          }
        }
      }
    },
    "/feed-health/health": {
      "get": {
        "tags": [
          "feed-health"
        ],
        "summary": "FeedHealth check service health",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Healthy"
          }
        }
      }
    },
    "/notary/v1/health": {
      "get": {
        "tags": [
          "notary"
        ],
        "summary": "DocAnchor service health",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Healthy"
          }
        }
      }
    },
    "/notary/v1/verify/{hash}": {
      "get": {
        "tags": [
          "notary"
        ],
        "summary": "Check a SHA-256 document hash against receipt Merkle roots (0 credits); on-chain anchoring is Coming soon",
        "x-credits": 0,
        "parameters": [
          {
            "name": "hash",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Verification status"
          }
        }
      }
    },
    "/attest/v1/health": {
      "get": {
        "tags": [
          "attest"
        ],
        "summary": "AttestXDC EAS service health",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Healthy"
          }
        }
      }
    },
    "/attest/v1/verify/{uid}": {
      "get": {
        "tags": [
          "attest"
        ],
        "summary": "Verify an on-chain EAS attestation UID on XDC (0 credits)",
        "x-credits": 0,
        "parameters": [
          {
            "name": "uid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Feed report record"
          }
        }
      }
    },
    "/masternode/health": {
      "get": {
        "tags": [
          "masternode"
        ],
        "summary": "NodeCheck masternode health check",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Healthy"
          }
        }
      }
    },
    "/nodewatch/health": {
      "get": {
        "tags": [
          "nodewatch"
        ],
        "summary": "NodeAlert public status service health",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Healthy"
          }
        }
      }
    },
    "/analytics/health": {
      "get": {
        "tags": [
          "analytics"
        ],
        "summary": "Analytics health check",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Healthy"
          }
        }
      }
    },
    "/analytics/api/latest.json": {
      "get": {
        "tags": [
          "analytics"
        ],
        "summary": "Latest XDC ecosystem KPIs (schema xdc-analytics/latest/v1)",
        "x-credits": 0,
        "responses": {
          "200": {
            "description": "Latest KPIs"
          }
        }
      }
    },
    "/portal/v1/auth/key-login": {
      "post": {
        "summary": "Sign in to workspace using an active paid API key",
        "responses": {
          "200": {
            "description": "Session created"
          },
          "401": {
            "description": "Invalid API key"
          },
          "403": {
            "description": "Paid subscription required"
          }
        }
      }
    },
    "/openapi.yaml": {
      "get": {
        "summary": "OpenAPI 3.1 specification in YAML (0 credits)",
        "responses": {
          "200": {
            "description": "OpenAPI YAML"
          }
        }
      }
    },
    "/api/waitlist": {
      "post": {
        "summary": "Submit email to FeedPlumb commercial & alerts waitlist (WAITLIST_OPEN=1)",
        "responses": {
          "200": {
            "description": "Recorded"
          }
        }
      }
    },
    "/portal/v1/me": {
      "get": {
        "summary": "Get active session profile, subscription plan tier, and credit balance",
        "responses": {
          "200": {
            "description": "Authenticated profile"
          }
        }
      }
    },
    "/portal/v1/team": {
      "get": {
        "summary": "List workspace team members and RBAC roles (owner, admin, developer, billing)",
        "responses": {
          "200": {
            "description": "Team members"
          }
        }
      },
      "post": {
        "summary": "Invite or update workspace team member role (owner, admin, developer, billing)",
        "responses": {
          "201": {
            "description": "Member added"
          }
        }
      }
    },
    "/portal/v1/sla": {
      "get": {
        "summary": "Calculate monthly SLA uptime percentage and automatic EUR / credit adjustment",
        "responses": {
          "200": {
            "description": "SLA calculation"
          }
        }
      },
      "post": {
        "summary": "Evaluate monthly SLA window and issue automated SLA credit adjustment",
        "responses": {
          "200": {
            "description": "SLA credit evaluation & adjustment"
          }
        }
      }
    },
    "/portal/v1/reports": {
      "get": {
        "summary": "List monthly reports, each with its status (available, coming_soon or not_offered)",
        "responses": {
          "200": {
            "description": "Reports index"
          }
        }
      }
    },
    "/portal/v1/reports/epoch-statement": {
      "get": {
        "summary": "Download monthly validator RewardStatement report (JSON or CSV)",
        "responses": {
          "200": {
            "description": "RewardStatement report"
          }
        }
      }
    },
    "/portal/v1/reports/reserve-proof": {
      "get": {
        "summary": "Not offered · FeedPlumb does not check issuer reserves (answers status not_offered with no figures)",
        "responses": {
          "200": {
            "description": "status not_offered, no reserve figures"
          }
        }
      }
    },
    "/portal/v1/alerts/test-fire": {
      "post": {
        "summary": "Send HMAC-SHA256 signed test notification to configured webhook or email",
        "responses": {
          "200": {
            "description": "Test alert sent"
          }
        }
      }
    },
    "/portal/v1/tools": {
      "get": {
        "summary": "List workspace tools and unified credit weights (0/1/2/5/25)",
        "responses": {
          "200": {
            "description": "Tools list"
          }
        }
      }
    },
    "/verify/v1/subnet/{block}": {
      "get": {
        "summary": "Coming soon · XDC Subnet checkpoint verification (no live subnet source yet; returns status coming_soon and no checkpoint)",
        "x-status": "coming_soon",
        "responses": {
          "200": {
            "description": "Subnet checkpoint proof envelope"
          }
        }
      }
    },
    "/releases/manifest.json": {
      "get": {
        "summary": "P5.1 · Open-source SDK & smart-contract release manifest with SHA-256 checksums (@feedplumb/feedkit, @feedplumb/pli-paymaster, @feedplumb/sdk)",
        "responses": {
          "200": {
            "description": "Release manifest JSON"
          }
        }
      }
    },
    "/portal/v1/waitlist": {
      "post": {
        "summary": "Submit email to FeedPlumb commercial & alerts waitlist (WAITLIST_OPEN=1)",
        "responses": {
          "200": {
            "description": "Recorded"
          }
        }
      }
    },
    "/portal/v1/sla/evaluate": {
      "get": {
        "summary": "P5.4 · Evaluate 99.9% Protocol / Pro uptime & freshness SLA compliance and calculate service credit adjustments",
        "responses": {
          "200": {
            "description": "SLA evaluation"
          }
        }
      },
      "post": {
        "summary": "P5.4 · Evaluate SLA window and optionally credit account balance with automated service credit adjustment",
        "responses": {
          "200": {
            "description": "SLA evaluation & applied credit lot"
          }
        }
      }
    },
    "/portal/v1/reports/monthly": {
      "get": {
        "summary": "P5.4 · Signed monthly JSON proof bundle (MeterKit usage, FP-2026-xxxxx VAT invoice summary, RWA oracle-reading snapshot, SLA attestation)",
        "responses": {
          "200": {
            "description": "Signed monthly report bundle"
          }
        }
      }
    },
    "/portal/v1/reports/monthly.pdf": {
      "get": {
        "summary": "P5.4 · Download monthly compliance & usage report as a valid %PDF-1.4 binary",
        "responses": {
          "200": {
            "description": "PDF binary"
          }
        }
      }
    },
    "/v1/rpc-watch": {
      "get": {
        "summary": "P5.3 · XDPoS v2 Quorum Certificate (QC) vote-signature summary & 4-region RPC latency/finality probe matrix",
        "responses": {
          "200": {
            "description": "RPC watch & QC status"
          }
        }
      }
    },
    "/verify/v1/rpc-watch": {
      "get": {
        "summary": "P5.3 · Public 0-credit signed proof bundle for XDPoS v2 QC & multi-region RPC probes",
        "responses": {
          "200": {
            "description": "Signed RPC watch proof"
          }
        }
      }
    },
    "/v1/subnet-ops/checkpoint": {
      "get": {
        "summary": "Coming soon · Latest XDC Subnet checkpoint (no live subnet source yet; returns status coming_soon and no checkpoint)",
        "x-status": "coming_soon",
        "responses": {
          "200": {
            "description": "Subnet checkpoint proof"
          }
        }
      },
      "post": {
        "summary": "Coming soon · Verify a submitted XDC Subnet checkpoint (not available yet; returns status coming_soon)",
        "x-status": "coming_soon",
        "responses": {
          "200": {
            "description": "Verified subnet checkpoint proof"
          }
        }
      }
    },
    "/verify/v1/subnet/{subnetId}": {
      "get": {
        "summary": "Coming soon · XDC Subnet checkpoint by subnetId (no live subnet source yet; returns status coming_soon and no checkpoint)",
        "x-status": "coming_soon",
        "responses": {
          "200": {
            "description": "Subnet checkpoint proof envelope"
          }
        }
      }
    },
    "/x402/v1/catalog": {
      "get": {
        "summary": "Coming soon: x402 v2 endpoint catalog and CAIP-2 (eip155:50 / eip155:51) pricing",
        "responses": {
          "200": {
            "description": "x402 v2 catalog"
          }
        }
      }
    },
    "/x402/v1/verdict/{pair}": {
      "get": {
        "summary": "Coming soon: x402 v2 oracle feed verdict",
        "responses": {
          "200": {
            "description": "Signed feed verdict"
          },
          "402": {
            "description": "Payment Required (PAYMENT-REQUIRED v2 header)"
          }
        }
      }
    },
    "/x402/v1/reserve/{token}": {
      "get": {
        "summary": "Not offered yet: x402 v2 RWA asset registry facts (issuer-stated; FeedPlumb does not check issuer reserves)",
        "responses": {
          "200": {
            "description": "RWA asset registry facts (rwa_asset_registry proof envelope)"
          },
          "402": {
            "description": "Payment Required (PAYMENT-REQUIRED v2 header)"
          }
        }
      }
    },
    "/x402/v1/node-health": {
      "get": {
        "summary": "Coming soon: x402 v2 XDPoS v2 QC and multi-region RPC health snapshot",
        "responses": {
          "200": {
            "description": "Signed node health snapshot"
          },
          "402": {
            "description": "Payment Required (PAYMENT-REQUIRED v2 header)"
          }
        }
      }
    },
    "/x402/v1/feed/{address}/verdict": {
      "get": {
        "tags": [
          "x402"
        ],
        "summary": "Feed verdict by Plugin feed proxy address (100 credits with an API key; same body as /x402/v1/verdict/{pair})",
        "parameters": [
          {
            "name": "address",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Signed feed verdict (oracle_feed_round proof envelope) for the pair the proxy serves"
          },
          "401": {
            "description": "No key while pay per call is off (api_key_required), or the X-FeedPlumb-Key that was sent is unknown or revoked (invalid_api_key)"
          },
          "402": {
            "description": "With a key: not enough credits. Without a key: x402 payment requirements (credits, EUR price excl. VAT, token amount); only when a treasury is configured"
          },
          "403": {
            "description": "Pay per request is off for this key, or its monthly cap in credits is reached (nothing is debited)"
          },
          "404": {
            "description": "Unknown subject (nothing is debited)"
          },
          "502": {
            "description": "The response could not be built; nothing is billed and a payment proof is not used"
          },
          "503": {
            "description": "A payment was sent while x402 pay per call is Coming soon (treasury_not_configured) or paid checkout is paused (checkout_paused)"
          }
        }
      }
    },
    "/x402/v1/masternode/{address}/health": {
      "get": {
        "tags": [
          "x402"
        ],
        "summary": "Coming soon · Masternode health (XDPoS role, blocks since last produced, missed rounds) (not served yet; returns 404)",
        "x-status": "coming_soon",
        "parameters": [
          {
            "name": "address",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "404": {
            "description": "Coming soon: this endpoint is not served yet"
          }
        }
      }
    },
    "/x402/v1/plugin-node/{address}/health": {
      "get": {
        "tags": [
          "x402"
        ],
        "summary": "Coming soon · Plugin node health (feeds served, submissions, rounds behind) (not served yet; returns 404)",
        "x-status": "coming_soon",
        "parameters": [
          {
            "name": "address",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "404": {
            "description": "Coming soon: this endpoint is not served yet"
          }
        }
      }
    },
    "/x402/health": {
      "get": {
        "summary": "Coming soon: x402 v2 payment facilitator health and CAIP-2 network status (eip155:50, eip155:51)",
        "responses": {
          "200": {
            "description": "x402 health"
          }
        }
      }
    },
    "/x402/v1/verdicts": {
      "get": {
        "tags": [
          "x402"
        ],
        "summary": "Feed verdict for a pair (100 credits with an API key). ?pair=BASE/QUOTE; PLI/USDT when omitted",
        "parameters": [
          {
            "name": "pair",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "example": "XDC/USDT"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Signed feed verdict (oracle_feed_round proof envelope)"
          },
          "401": {
            "description": "No key while pay per call is off (api_key_required), or the X-FeedPlumb-Key that was sent is unknown or revoked (invalid_api_key)"
          },
          "402": {
            "description": "With a key: not enough credits. Without a key: x402 payment requirements (credits, EUR price excl. VAT, token amount); only when a treasury is configured"
          },
          "403": {
            "description": "Pay per request is off for this key, or its monthly cap in credits is reached (nothing is debited)"
          },
          "404": {
            "description": "Unknown subject (nothing is debited)"
          },
          "502": {
            "description": "The response could not be built; nothing is billed and a payment proof is not used"
          },
          "503": {
            "description": "A payment was sent while x402 pay per call is Coming soon (treasury_not_configured) or paid checkout is paused (checkout_paused)"
          }
        }
      }
    },
    "/x402/v1/rwa/cgo/reserve-facts": {
      "get": {
        "summary": "ComTech Gold (CGO) asset registry facts (issuer-stated; FeedPlumb does not check issuer reserves; no Merkle root). 100 credits with an API key",
        "responses": {
          "200": {
            "description": "CGO registry facts (FeedPlumb does not check issuer reserves)"
          },
          "402": {
            "description": "Payment Required (CAIP-2 eip155:50 / eip155:51)"
          }
        }
      }
    },
    "/x402/v1/receipts/{id}": {
      "get": {
        "summary": "Coming soon: verify an x402 v2 AgentReceipts payment receipt by ID",
        "responses": {
          "200": {
            "description": "Receipt record"
          }
        }
      }
    },
    "/rwa/docanchor/standards-spec": {
      "get": {
        "summary": "Public specification (0 credits) for DocAnchor: non-qualified time stamps (eIDAS Art. 41(1)) and ledger records (Art. 45k(1)), RFC 3161; transferable records (coming soon) designed with UNCITRAL MLETR in mind",
        "responses": {
          "200": {
            "description": "DocAnchor & MLETR standards specification"
          }
        }
      }
    },
    "/rwa/docanchor/register": {
      "post": {
        "summary": "DocAnchor registration: simple record (eIDAS Art. 41(1), RFC 3161) or transferable trade record (coming soon), 200 credits. The RFC 3161 time stamp (FreeTSA.org, non-qualified) is requested once per hourly batch, so the record shows timestampStatus \"pending\" for up to an hour after you pay.",
        "responses": {
          "201": {
            "description": "Registered DocAnchor proof certificate"
          }
        }
      }
    },
    "/rwa/docanchor/verify": {
      "get": {
        "summary": "Public 0-credit verification of a DocAnchor registration, its RFC 3161 batch time stamp (pending until the hourly batch token arrives), the transferable-record state & optional settlement cross-reference",
        "responses": {
          "200": {
            "description": "Verification result"
          }
        }
      },
      "post": {
        "summary": "Public 0-credit verification of a DocAnchor registration, its RFC 3161 batch time stamp (pending until the hourly batch token arrives), the transferable-record state & optional settlement cross-reference",
        "responses": {
          "200": {
            "description": "Verification result"
          }
        }
      }
    },
    "/rwa/docanchor/etr/issue": {
      "post": {
        "summary": "Issue a transferable trade record (coming soon; legal status under review); alias of POST /v1/notary/etr/issue (mode defaults to layer_2_mletr_etr; requires etrSingularityId and exclusiveControlHolder; Pro tier)",
        "responses": {
          "200": {
            "description": "Transferable record issuance record"
          },
          "400": {
            "description": "missing_mletr_etr_fields"
          },
          "403": {
            "description": "Plan tier does not include ETR issuance"
          }
        }
      }
    },
    "/rwa/docanchor/etr/transfer": {
      "post": {
        "summary": "Transfer control of a transferable trade record in the FeedPlumb registry (coming soon; 200 credits)",
        "responses": {
          "200": {
            "description": "Control transfer receipt"
          }
        }
      }
    },
    "/rwa/docanchor/etr/endorse": {
      "post": {
        "summary": "Endorse a transferable trade record in the FeedPlumb registry (coming soon; 200 credits)",
        "responses": {
          "200": {
            "description": "Endorsement receipt"
          }
        }
      }
    },
    "/rwa/docanchor/etr/pledge": {
      "post": {
        "summary": "Pledge a transferable trade record in the FeedPlumb registry (coming soon; 200 credits)",
        "responses": {
          "200": {
            "description": "Pledge receipt"
          }
        }
      }
    },
    "/rwa/docanchor/etr/change-medium": {
      "post": {
        "summary": "Record a change of medium (paper to electronic or back) for a transferable trade record (coming soon; 200 credits)",
        "responses": {
          "200": {
            "description": "Change-of-medium receipt"
          }
        }
      }
    },
    "/rwa/iso20022/standards-spec": {
      "get": {
        "summary": "Public 0-credit ISO 20022 (2019/2026 Release), ISO 17442 LEI, ISO 11649 SCOR, ISO 4217 & ISO 24165 DTI financial messaging specification",
        "responses": {
          "200": {
            "description": "ISO 20022 financial messaging & settlement specification"
          }
        }
      }
    },
    "/rwa/iso20022/validate": {
      "get": {
        "summary": "Public 0-credit validator for ISO 20022 messages (pacs.008, pain.001, camt.053, tsmt.018, semt.002), ISO 17442 LEI, ISO 11649 SCOR & UETR",
        "responses": {
          "200": {
            "description": "ISO 20022 validation result"
          }
        }
      },
      "post": {
        "summary": "Public 0-credit validator for ISO 20022 messages (pacs.008, pain.001, camt.053, tsmt.018, semt.002), ISO 17442 LEI, ISO 11649 SCOR & UETR",
        "responses": {
          "200": {
            "description": "ISO 20022 validation result"
          }
        }
      }
    },
    "/rwa/iso20022/generate": {
      "post": {
        "summary": "Generate canonical W3C XML ISO 20022 financial/trade settlement message (pacs.008, pain.001, camt.053, tsmt.018, semt.002) with an XDC reference (500 credits; on-chain anchoring is Coming soon)",
        "responses": {
          "201": {
            "description": "Canonical ISO 20022 XML message (XDC anchor Coming soon)"
          }
        }
      }
    },
    "/apis/remittrace/iso20022": {
      "post": {
        "summary": "ISO 20022 pacs.008 / camt.053 remittance trace, canonical XML & XDC settlement proof (500 credits)",
        "responses": {
          "200": {
            "description": "ISO 20022 trace proof"
          }
        }
      }
    },
    "/apis/lc-precheck/ucp600": {
      "post": {
        "summary": "UCP 600 + eUCP v2.1 Letter of Credit document discrepancy precheck (500 credits)",
        "responses": {
          "200": {
            "description": "UCP 600 compliance result"
          }
        }
      }
    },
    "/apis/mica-whitelist/check": {
      "get": {
        "summary": "MiCA CASP / ART / EMT whitelist & counterparty registry verification (100 credits)",
        "responses": {
          "200": {
            "description": "MiCA check result"
          }
        }
      }
    },
    "/rwa/sla-reports": {
      "get": {
        "summary": "Coming soon · Monthly RWA & oracle feed SLA reports (not published yet; 0 credits, returns status coming_soon and an empty list)",
        "x-status": "coming_soon",
        "responses": {
          "200": {
            "description": "SLA audit reports"
          }
        }
      }
    },
    "/rwa/reserve-history": {
      "get": {
        "summary": "RWA asset registry facts (issuer-stated, unverified; FeedPlumb does not check issuer reserves, so there is no reserve history) (100 credits)",
        "responses": {
          "200": {
            "description": "RWA asset registry facts"
          }
        }
      }
    },
    "/rwa/subnet-checkpoints": {
      "get": {
        "summary": "Coming soon · XDC Subnet checkpoints (no live subnet source yet; 0 credits, returns status coming_soon and an empty list)",
        "x-status": "coming_soon",
        "responses": {
          "200": {
            "description": "Subnet checkpoints"
          }
        }
      }
    },
    "/data/feeds": {
      "get": {
        "summary": "Live XDC oracle feeds catalog and latest round values",
        "responses": {
          "200": {
            "description": "Feeds catalog"
          }
        }
      }
    },
    "/notary/v1/hash": {
      "post": {
        "summary": "Coming soon: anchor a 32-byte SHA-256 document hash on XDC (200 credits). The notary is read-only until anchoring launches.",
        "responses": {
          "200": {
            "description": "Anchored receipt (Coming soon)"
          },
          "202": {
            "description": "Queued for batch anchor (Coming soon)"
          }
        }
      }
    },
    "/attest/v1/index": {
      "get": {
        "summary": "List non-PII EAS attestations indexed on XDC",
        "responses": {
          "200": {
            "description": "Attestation index"
          }
        }
      }
    },
    "/statements/": {
      "get": {
        "summary": "XDC Masternode Monthly Epoch & Reward Statements landing page and generator",
        "responses": {
          "200": {
            "description": "Statements HTML"
          }
        }
      }
    },
    "/nodewatch/status.json": {
      "get": {
        "summary": "XDPoS v2 quorum certificate (QC) vote-signature decoding & multi-region RPC latency probe",
        "responses": {
          "200": {
            "description": "NodeWatch status JSON"
          }
        }
      }
    },
    "/portal/v1/pay/matrix": {
      "get": {
        "tags": [
          "portal"
        ],
        "summary": "Service-specific multi-token acceptance matrix and live oracle FX rates (multi-sig treasury: not deployed yet, Coming soon)",
        "responses": {
          "200": {
            "description": "Payment matrix JSON; the multi-sig treasury section reports status not_deployed (Coming soon)"
          }
        }
      }
    },
    "/portal/v1/pay/quote": {
      "post": {
        "tags": [
          "portal"
        ],
        "summary": "Validate service-token pair against acceptance matrix and compute live FX and VAT quote",
        "responses": {
          "200": {
            "description": "Signed payment quote"
          },
          "422": {
            "description": "Token not accepted for requested service category"
          }
        }
      }
    },
    "/portal/v1/pay/settle": {
      "post": {
        "tags": [
          "portal"
        ],
        "summary": "Record a verified payment and append an immutable double-entry bookkeeping record (multi-sig treasury: not deployed yet, Coming soon)",
        "responses": {
          "201": {
            "description": "Bookkeeping journal entry recorded"
          },
          "422": {
            "description": "Token not accepted for requested service category"
          }
        }
      }
    }
  }
}
