discover
Find pay-per-use APIs for AI agents in the catalog of Digital Vending Machines. Keyword search is free, natural-language search $0.01. No account, no API key.
discover is dvmkit's catalog of Digital Vending Machines (DVMs), the pay-per-use APIs AI agents call with no account and no API key. It finds DVMs that can handle a task by keyword or natural language, or browses the whole registry. Ranking draws on delivery evidence and verified feedback.
- What it does: searches and browses the DVM catalog. It backs the
dvm searchanddvm browseCLI commands, so most callers never address it directly. - Price: Keyword search and browse are free; $0.01 per natural-language search, charged only when that mode is available. See Pricing.
- Pays with: USDC on Base, USDC.e on Tempo, or Bitcoin ecash (Cashu) per job. Bitcoin Lightning can fund prepaid credit.
- Endpoint:
https://discover.dvmkit.ai, with two capabilities:searchandbrowse. Natural-language search is also offered on the one-request x402 route for stock x402 clients.
Published reference. This page is the source of truth for discover's documented inputs, outputs, prices, and errors. The running service publishes its current capability schemas and advertised prices in its live descriptor. Full
dvm searchanddvm browseoutput shapes are in the dvm CLI reference.
Keyword/tag search, browse, and quotes require a signed request. The CLI signs with your identity; use version 0.8.2 or later for search and browse.
For signed callers, discover offers prepaid credit from $0.10 to $20.00. Its live descriptor lists the funding methods, lifetime, and Lightning receive minimum. Lightning-funded credit comes back as Bitcoin ecash when drained. See Credits.
Caller 0.9.0 can pay the later natural-language search request from an existing balance when the service advertises credit.balance_payment: true. A completed search uses $0.01. A failed signed search releases the hold back to the balance, which can be drained.
One-request x402 search
A stock x402 client, such as @x402/fetch, can run a natural-language search in one paid request, with no dvmkit identity. Send POST https://discover.dvmkit.ai/v1/x402/search with a flat JSON body such as {"query":"Find a service that transcribes audio"}. Optional tags, credit, and limit filters mean the same as on /v1/job. The unpaid request returns HTTP 402 with a PAYMENT-REQUIRED header asking for $0.01 in USDC on Base. The client signs that payment and sends the same request again.
This route runs natural-language search only. Keyword mode is refused here; keyword search and browse stay on signed /v1/job requests. A search runs for at most 30 seconds. It costs $0.01, collected only if the search succeeds. A failed search, including one against an empty catalog (registry_empty), is not charged. A successful response carries status: "completed", a signed receipt, and a PAYMENT-RESPONSE header naming the settlement transaction.
The response's summary is one line for a human, such as Found 3 matching services or Showing 8 of 10 matching services. The results are in an application/json artifact in messages. Its data is a JSON string: parse it to get { results, query, mode, total }, with the same result fields as a /v1/job search. To keep the response under the inline size limit, a listing too large to fit is skipped and the next match takes its place. total still counts every match. If matches exist but none fits, the search fails with result_too_large and is not charged. A /v1/job search still returns its JSON in summary.
Let the HTTP client wait at least 60 seconds. Payments explains charge_outcome, including what to do when it reads unknown.
Unsigned Cashu payments
On /v1/job, the search capability with mode: "natural_language" accepts one unsigned NUT-24 Cashu payment. Each search costs $0.01 upfront, with no prepaid credit and no refund if the job fails. Unsigned keyword/tag search, browse, and natural-language search on an instance without an LLM key receive 401 auth_error before payment.
Send an unsigned POST /v1/job without payment to get an HTTP 402 challenge in X-Cashu. Pay it and resend the same body with the Cashu token in X-Cashu, without X-Cashu-Request-Id. If the search completes within the inline wait (10 seconds by default), its result returns in messages in the same paid response, up to 1,048,576 serialised UTF-8 bytes. Otherwise, keep job_id and job_token to poll and read the result with X-Job-Token. See the wire contract.
search
Query the catalog. Two modes:
keyword(free): substring match on names, tags, descriptions, capability names and descriptions, and input-schema fields.natural_language($0.01, paid): an LLM extracts keywords from the query, then keyword search runs. Requires the operator to have configured an LLM key; an instance without one quotes signed callers at $0 and returnsnl_unavailable.
For signed callers, the $0.01 is charged mid-job, only after the instance confirms natural-language mode is available. A keyword search, or a no-key instance, is never billed. Read the price before submitting with dvm quote -d dvmkit--discover/search.
dvm search "transcription"
dvm search --credit
dvm search "summarise a PDF" --mode natural_language
dvm quote -d dvmkit--discover/search --data '{"query":"transcription","mode":"natural_language"}'Pass credit: true, or use dvm search --credit, to keep only DVMs that advertise prepaid credit. It works alone or alongside text and tag filters. Each match carries the structured terms in credit and a short summary in display.credit.
browse
Free. Paginate the catalog. Use it as the entry point for agents that don't yet know what to search for. All inputs optional:
| Field | Type | Default |
|---|---|---|
tags | string[] (exact-tag pre-filter, AND semantics) | unset |
builder | string (owner-handle equality, case-insensitive) | unset |
source | "all" | "platform" (platform hides external DVMs) | "all" |
sort | "reputation" | "name" | "recency" | "reputation" |
limit | number (max 50) | 10 |
offset | number | 0 |
Returns { entries, total, offset, limit, query: null }, where each entry has the same agent-friendly display block as search results (minus score / match_reason). total is the filtered catalog count before pagination. The CLI expands platform DVMs into capability rows, so its entries array can contain more rows than the requested page size. See browse output for the count fields.
dvm browse
dvm browse --tag audio --limit 5
dvm browse --source platform --sort nameHow results are ordered
Search starts with relevance to the query. Delivery evidence and receipt-verified feedback inform the order. Work ended by the caller does not count toward the delivery rate. A listing without evidence starts neutral; traffic volume alone does not earn a higher rank. Speed, price, and listing age do not affect the score.
Unreachable services appear below reachable services. Within each of those groups, results without payment-behavior warnings appear before flagged results. The default browse sort, reputation, uses the same evidence and warning rules. Browse's name and recency sorts instead follow the selected alphabetical or registration-time order.
Results distinguish delivery measured by dvmkit from delivery evidenced by receipts callers submitted. Feedback comes from eligible paid jobs with verified receipts. A caller key identifies a signing identity, not a verified person. The displayed delivery fraction shows how many jobs with payment presented or confirmed were delivered. The ranking score uses delivery evidence alongside other signals.
The result's trust block carries this evidence. capabilities carries each capability's advertised price and observed speed. Missing evidence stays absent, and a missing price does not mean the service is free. The CLI supplies words an agent can relay in display; see discovery result fields.
Appearing in results is not an endorsement. See the terms.
Pricing
| Path | Cost |
|---|---|
keyword search | Free |
browse | Free |
natural_language search | $0.01 USD (signed: mid-job; unsigned x402: collected only on success; unsigned Cashu: prepaid; only if available) |
Prepaid credit
| Field | Value |
|---|---|
| Minimum funding | $0.10 |
| Maximum residual balance | $20.00 |
| Credit lifetime | 90 days from the most recent funding |
Error codes
The failure surface is intentionally thin: no typed-error layer.
| Code | Trigger | Recovery |
|---|---|---|
nl_unavailable | natural_language mode requested but the instance has no LLM key | Fall back to mode: "keyword" and retry. No payment was taken |
nl_search_failed | The LLM call itself failed after payment (a genuine outage, timeout, or unrecoverable validation error), not an allowance problem | Retry, or fall back to mode: "keyword" |
provider_allowance_exhausted | The operator's own LLM plan is out of credit | Operator issue. Retry once the plan is topped up, or use mode: "keyword" |
result_too_large | Matches exist, but none fits the x402 response, on the x402 route only | Nothing was charged. Narrow the query or add tags, then retry |
registry_empty | The catalog is empty, on the x402 route only (a /v1/job search returns no results instead) | Nothing was charged. Retry later |
REGISTRY_URL is required | Boot-time throw when the DVM is deployed without a registry URL | Operator misconfiguration. The process never accepts jobs |
For signed callers, nl_search_failed and provider_allowance_exhausted both release the $0.01 hold onto your own credit. You can drain that balance. Unsigned Cashu payers get no refund on failure. On the x402 route a failed search is not charged. See If a job fails.
See also
- Explore the catalog · dvm CLI reference · Caller quickstart
- Other first-party DVMs: scrape · scribe · narrate · cast · satoshi-quotes
cast
Pay-per-use podcast hosting for AI agents: publish audio to an RSS feed any podcast app can follow, $0.02 an episode plus storage. No account, no API key.
narrate
Pay-per-use text-to-speech API for AI agents: text or dialogue to spoken audio from $0.0001 a character ($100 per million). No account, no API key.