nohumans.directory Discover API
The Discover API from nohumans.directory — 1 operation(s) for discover.
The Discover API from nohumans.directory — 1 operation(s) for discover.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.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.curl "https://apis.io/api/v1/apis/nohumans-directory:nohumans-directory-discover-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a 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.
openapi: 3.2.0
info:
title: Nohumans Directory Discover API
version: 1.0.0
contact:
email: hello@nohumans.directory
license:
name: CC-BY-4.0 (directory data)
identifier: CC-BY-4.0
x-guidance: 'Free discovery: GET /v1/discover?q= to find paid x402 services by need, GET /v1/listings/{id} for the full record, GET /v1/resolve?url= when you already hold an endpoint URL. Paid routes (x402 v2, USDC on Base): GET /v1/listings/{id}/verdict $0.005; GET /v1/listings/{id}/purchases $0.01; POST /v1/listings/{id}/verify-now from $0.25 (listing owners only); GET /v1/demand/clusters $5; GET /v1/verdicts $0.10; GET /v1/listings/{id}/owner-report $1 (listing owners only); GET /v1/demand/report $5. Every fact the verdict folds in is free on the listing record. Prefer the MCP server at /mcp if your framework speaks it.'
description: 'Operations tagged Discover across 2 of this provider''s published API definitions: nohumans-directory-openapi.json, openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.nohumans.directory
- url: https://nohumans.directory
tags:
- name: Discover
paths:
/v1/discover:
get:
summary: Search listings (verified ranked first, then relevance, probe score and…
parameters:
- name: q
in: query
schema:
type: string
description: 'Semantic query — describe the actual need in words; improves the directory''s demand data. Aliases: search, query'
- name: category
in: query
schema:
type: string
example: data.fx
- name: max_price
in: query
schema:
type: number
- name: min_score
in: query
schema:
type: number
minimum: 0
maximum: 1
- name: protocol
in: query
schema:
type: string
enum:
- x402
- mpp
description: Only listings offering this payment protocol (as observed on the endpoint). Omit for any.
- name: mpp_method
in: query
schema:
type: string
example: stripe
description: Only listings offering this MPP method (as the endpoint names it). Implies protocol=mpp.
- name: evidence
in: query
schema:
type: string
enum:
- paid_verified
description: 'Only listings bought with real USDC that delivered, with no settled purchase since that failed. Alias: paid_verified=true'
- name: limit
in: query
schema:
type: integer
minimum: 1
maximum: 50
default: 10
responses:
'200':
description: Ranked results
content:
application/json:
schema:
type: object
properties:
count:
type: integer
results:
type: array
items:
$ref: '#/components/schemas/ListingSummary'
'400':
description: 'invalid_parameter: a filter value is not valid (the body names it); nothing was searched'
security: []
tags:
- Discover
operationId: getV1Discover
x-operation-id-source: derived
servers:
- url: https://api.nohumans.directory
- url: https://nohumans.directory
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.'
securitySchemes:
claimToken:
type: apiKey
in: header
name: x-claim-token
description: Returned once at submission or via the claim flow; x-edit-token accepted as alias
bearer:
type: http
scheme: bearer
description: 'Same claim token as Authorization: Bearer'
x-refined-from:
- nohumans-directory-openapi.json
- openapi.json
x-mcp:
endpoint: https://api.nohumans.directory/mcp
transport: streamable-http
tools:
- find_paid_service
- get_service_details
- resolve_endpoint
- what_agents_are_asking_for
x-discovery:
version: '2026-09-03'