nohumans.directory · Schema

ListingSummary

DirectoryAPI RegistryPaid API VerificationAI AgentsMCP Service

Properties

Name Type Description
id string
name string
description string
endpoint_url string
category string
kind string
price_amount number
price_currency string
chains array Networks you can PAY on, as declared by the seller. Not the data or chains the service covers; observed_network is what the live 402 named.
status string
status_changed_at integer
has_sample boolean
onchain_scope stringnull What the on-chain figures describe, in words: this listing's own payTo, or a wallet shared by N listings. Read before quoting them.
probes_passed integernull
probes_failed integernull
paid_verified_at integernull Latest delivered purchase by our scout (unix seconds); paid_verified_at_iso is the same instant as ISO 8601. One purchase is not a continuing guarantee.
x402_version integernull
onchain_unique_payers_30d integernull Distinct wallets that sent USDC to this listing's payTo on Base in the window, from our own index (since 2026-08-29). CEILING on customer count — every incoming USDC transfer counts; operator self-fun
onchain_tx_count_30d integernull
onchain_volume_usd_30d numbernull
onchain_checked_at integernull Last successful read; null = read before 2026-08-28 (time not retained)
onchain_source stringnull 'index' = our own Base USDC index, no ceiling; null = legacy third-party read (150-item cap possible)
onchain_count_capped boolean Legacy rows only: tx_count is a floor
onchain_payto_shared_listings integernull Active listings declaring the same payTo — figures belong to the address; never sum across listings
onchain_daily arraynull Per-UTC-day series, today + 30 prior days (index rows only). A 30d sum hides cliffs.
onchain_shape objectnull 25 most recent payments classified by calldata: eip3009 = transferWithAuthorization (x402 exact scheme); plain = ordinary transfer(); other = unclassified. USDC inflow is not x402 revenue; this tells
score numbernull
probe_count integer Every counted probe, passes AND failures; see probes_passed.
p50_latency_ms numbernull Median over the last 7 days, timeouts included; null under 5 probes. A running average before 2026-09-24.
p95_latency_ms numbernull
last_probed_at integernull
paid_verified boolean
paid_verification_latest objectnull The MOST RECENT settled purchase, whatever it found — delivered true or false, with the failure reason and tx hash. paid_verification above reports the latest SUCCESS and may be older; read both. A re
payto_sentinel boolean The endpoint's live challenge names a burn address (zero/dead) that cannot receive funds. A payment sent as instructed is destroyed and nothing is delivered. Independent of status: such a listing can
payto_unstable boolean The endpoint served several different payment addresses across recent checks; there is no stable destination to trust. Verify the address in the challenge you receive immediately before paying.
payto_note stringnull Plain-language warning when payto_sentinel or payto_unstable is set; null otherwise.
paid_depth object How much paid evidence stands behind this listing, as a rung earned by delivering when bought: none, paid_verified (once), 2x (twice, >=48h apart), held (twice, across a seller-caused change), Nwk (ac
evidence_tier string
evidence_note string
verdict_age_seconds integernull
payment_protocols array Protocols the endpoint's own 402 offered on our unpaid probes (since 2026-09-26). Paid verification and on-chain figures cover x402 on Base only.
mpp_methods arraynull MPP (WWW-Authenticate: Payment) methods as the endpoint names them; the record adds mpp_offers and mpp_note.
View JSON Schema on GitHub

JSON Schema

nohumans-directory-listing-summary-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/nohumans-directory/json-schema/nohumans-directory-listing-summary-schema.json",
  "title": "ListingSummary",
  "x-generated": "2026-11-19",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/nohumans-directory-openapi.json#/components/schemas/ListingSummary",
  "type": "object",
  "additionalProperties": true,
  "properties": {
    "id": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "endpoint_url": {
      "type": "string"
    },
    "category": {
      "type": "string"
    },
    "kind": {
      "type": "string",
      "enum": [
        "api",
        "agent"
      ]
    },
    "price_amount": {
      "type": "number"
    },
    "price_currency": {
      "type": "string"
    },
    "chains": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Networks you can PAY on, as declared by the seller. Not the data or chains the service covers; observed_network is what the live 402 named."
    },
    "status": {
      "type": "string",
      "enum": [
        "verified",
        "unverified",
        "failing"
      ]
    },
    "status_changed_at": {
      "type": "integer"
    },
    "has_sample": {
      "type": "boolean"
    },
    "onchain_scope": {
      "type": [
        "string",
        "null"
      ],
      "description": "What the on-chain figures describe, in words: this listing's own payTo, or a wallet shared by N listings. Read before quoting them."
    },
    "probes_passed": {
      "type": [
        "integer",
        "null"
      ]
    },
    "probes_failed": {
      "type": [
        "integer",
        "null"
      ]
    },
    "paid_verified_at": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Latest delivered purchase by our scout (unix seconds); paid_verified_at_iso is the same instant as ISO 8601. One purchase is not a continuing guarantee."
    },
    "x402_version": {
      "type": [
        "integer",
        "null"
      ]
    },
    "onchain_unique_payers_30d": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Distinct wallets that sent USDC to this listing's payTo on Base in the window, from our own index (since 2026-08-29). CEILING on customer count — every incoming USDC transfer counts; operator self-funding inflates it; see onchain_shape"
    },
    "onchain_tx_count_30d": {
      "type": [
        "integer",
        "null"
      ]
    },
    "onchain_volume_usd_30d": {
      "type": [
        "number",
        "null"
      ]
    },
    "onchain_checked_at": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Last successful read; null = read before 2026-08-28 (time not retained)"
    },
    "onchain_source": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "index",
        null
      ],
      "description": "'index' = our own Base USDC index, no ceiling; null = legacy third-party read (150-item cap possible)"
    },
    "onchain_count_capped": {
      "type": "boolean",
      "description": "Legacy rows only: tx_count is a floor"
    },
    "onchain_payto_shared_listings": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Active listings declaring the same payTo — figures belong to the address; never sum across listings"
    },
    "onchain_daily": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "day": {
            "type": "string"
          },
          "tx": {
            "type": "integer"
          },
          "payers": {
            "type": "integer"
          },
          "usd": {
            "type": "number"
          }
        }
      },
      "description": "Per-UTC-day series, today + 30 prior days (index rows only). A 30d sum hides cliffs."
    },
    "onchain_shape": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "sample_n": {
          "type": "integer"
        },
        "eip3009": {
          "type": "integer"
        },
        "plain": {
          "type": "integer"
        },
        "other": {
          "type": "integer"
        },
        "sampled_at": {
          "type": "integer"
        }
      },
      "description": "25 most recent payments classified by calldata: eip3009 = transferWithAuthorization (x402 exact scheme); plain = ordinary transfer(); other = unclassified. USDC inflow is not x402 revenue; this tells them apart"
    },
    "score": {
      "type": [
        "number",
        "null"
      ]
    },
    "probe_count": {
      "type": "integer",
      "description": "Every counted probe, passes AND failures; see probes_passed."
    },
    "p50_latency_ms": {
      "type": [
        "number",
        "null"
      ],
      "description": "Median over the last 7 days, timeouts included; null under 5 probes. A running average before 2026-09-24."
    },
    "p95_latency_ms": {
      "type": [
        "number",
        "null"
      ]
    },
    "last_probed_at": {
      "type": [
        "integer",
        "null"
      ]
    },
    "paid_verified": {
      "type": "boolean"
    },
    "paid_verification_latest": {
      "type": [
        "object",
        "null"
      ],
      "description": "The MOST RECENT settled purchase, whatever it found — delivered true or false, with the failure reason and tx hash. paid_verification above reports the latest SUCCESS and may be older; read both. A record that can only improve is a claim, not a record.",
      "properties": {
        "at": {
          "type": "integer"
        },
        "delivered": {
          "type": "boolean"
        },
        "tx_hash": {
          "type": "string"
        },
        "amount_usdc": {
          "type": "number"
        },
        "failure_reason": {
          "type": [
            "string",
            "null"
          ]
        },
        "failure_kind": {
          "type": "string",
          "enum": [
            "any_buyer",
            "quality",
            "request_dependent"
          ],
          "description": "On a purchase that did not deliver (since 2026-11-19): any_buyer = nothing usable could come back whatever was asked (5xx, a second 402, empty answer, dropped connection); quality = an answer came back but stale against the listing's promise or not the declared shape; request_dependent = the request as made was refused or answered in an undeclared form. https://nohumans.directory/methodology#failure-kind-1119"
        },
        "note": {
          "type": "string"
        }
      }
    },
    "payto_sentinel": {
      "type": "boolean",
      "description": "The endpoint's live challenge names a burn address (zero/dead) that cannot receive funds. A payment sent as instructed is destroyed and nothing is delivered. Independent of status: such a listing can pass every protocol check and still be unpayable. Read payto_note."
    },
    "payto_unstable": {
      "type": "boolean",
      "description": "The endpoint served several different payment addresses across recent checks; there is no stable destination to trust. Verify the address in the challenge you receive immediately before paying."
    },
    "payto_note": {
      "type": [
        "string",
        "null"
      ],
      "description": "Plain-language warning when payto_sentinel or payto_unstable is set; null otherwise."
    },
    "paid_depth": {
      "type": "object",
      "description": "How much paid evidence stands behind this listing, as a rung earned by delivering when bought: none, paid_verified (once), 2x (twice, >=48h apart), held (twice, across a seller-caused change), Nwk (across N>=3 weeks), failed_rebuy (delivered, then failed the latest purchase). Money never buys a rung.",
      "properties": {
        "rung": {
          "type": "string"
        },
        "deliveries": {
          "type": "integer"
        },
        "span_weeks": {
          "type": "integer"
        },
        "first_ok_at": {
          "type": [
            "integer",
            "null"
          ]
        },
        "last_ok_at": {
          "type": [
            "integer",
            "null"
          ]
        },
        "last_attempt_ok": {
          "type": [
            "integer",
            "null"
          ]
        },
        "through_change": {
          "type": "boolean"
        }
      }
    },
    "evidence_tier": {
      "type": "string",
      "enum": [
        "payer_reported",
        "paid_verified",
        "probe_verified",
        "probe_only",
        "unproven"
      ]
    },
    "evidence_note": {
      "type": "string"
    },
    "verdict_age_seconds": {
      "type": [
        "integer",
        "null"
      ]
    },
    "payment_protocols": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "x402",
          "mpp"
        ]
      },
      "description": "Protocols the endpoint's own 402 offered on our unpaid probes (since 2026-09-26). Paid verification and on-chain figures cover x402 on Base only."
    },
    "mpp_methods": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "string"
      },
      "description": "MPP (WWW-Authenticate: Payment) methods as the endpoint names them; the record adds mpp_offers and mpp_note."
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/nohumans-directory-listing-summary"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.