# Delx Commerce buyer skill

Use Delx Commerce when an autonomous agent needs a paid machine result without
creating an account or managing an API key.

## Economic primitives (optional — not x402 catalog)

When the job is **future capacity**, **judgment before high-risk action**, or a
**single-purpose multi-agent firm** — use Commerce economic primitives (durable
local runtime, non-custodial receipts). These are **not** Protocol recovery and
do **not** hold USDC.

**Release truth:** current stage is private `private_beta`. The named loopback
deployment has live auth, signed receipts, encrypted recovery, and rollback
evidence; human pages and the manifest remain discovery/documentation and
mutation routes are not approved as public endpoints. Use synthetic or bounded
private data only until the remaining release gates pass.

| Need | Object | Start |
|------|--------|--------|
| Reserve capacity for a delivery window | Future request | https://commerce.delx.ai/economic/futures · `POST /api/v1/economic/futures/open` |
| Verdict on spend/publish/irreversible | Matter | https://commerce.delx.ai/economic/judgment · `POST /api/v1/economic/matters/open` |
| Temporary firm with human veto + splits | Firm | https://commerce.delx.ai/economic/firm · `POST /api/v1/economic/firms/incorporate` |

Machine hub: https://commerce.delx.ai/economic/manifest.json  
Normative docs: https://commerce.delx.ai/docs/economic/README.md
Run locally/private: `npm run economic:start` then `GET /ready` and product list
routes under `/api/v1/economic/*`.

## Preferred entry (discovery capsule)

Read the evidence-backed capsule first — proven converters, packs, skills, and
honest blocked gaps in one hop:

- Machine: https://commerce.delx.ai/discover-now.json  
- Human: https://commerce.delx.ai/discover-now  
- Attribution on paid calls from this path: `x-delx-source: discovery-capsule-now`

## Fast path: micro-utils that already convert (CLI)

External agents have already paid for these micro-USDC routes via AgentCash.
Prefer this pack when the job is DNS, QR, FX, or a cheap image—not web search.

| Need | Route | Price | Pack |
|------|--------|-------|------|
| DNS lookup for a hostname | `POST /api/v1/x402/dns-lookup` | 0.01 USDC | [agent-micro-utils](https://commerce.delx.ai/packs/agent-micro-utils.json) |
| QR code image | `POST /api/v1/x402/qr-code` | 0.001 USDC | same pack |
| ECB FX reference rates | `POST /api/v1/x402/fx-rates` | 0.001 USDC | same pack |
| Generate an image (draft) | `POST /api/v1/x402/image` | 0.01 USDC | same pack |
| Generate a pro image | `POST /api/v1/x402/image-hq` | 0.06 USDC | same pack |

```bash
npx agentcash@latest fetch https://api.delx.ai/api/v1/x402/dns-lookup \
  -m POST -H 'content-type: application/json' \
  -H 'x-delx-source: skill-delx-micro-utils' \
  --payment-network base --max-amount 0.01 \
  -b '{"domain":"example.com","record_type":"A"}'
```

Portable skill: `skills/delx-micro-utils/SKILL.md`  
Pack: https://commerce.delx.ai/packs/agent-micro-utils.json

## Fast path: already have a public URL?

**Default to extract — not web search.** Delx general web search is blocked.

| Need | Route | Price | Pack |
|------|--------|-------|------|
| Clean readable text from one URL | `POST /api/v1/x402/page-extract` | 0.01 USDC | [extract-website-content](https://commerce.delx.ai/packs/extract-website-content.json) |
| One-call site report (metadata, links, forms, contacts, feeds) | `POST /api/v1/x402/website-intelligence-report` | 0.01 USDC | same pack |

```bash
# Page extract
npx agentcash@latest fetch https://api.delx.ai/api/v1/x402/page-extract \
  -m POST -H 'content-type: application/json' \
  -H 'x-delx-source: skill-delx-extract-website' \
  --payment-network base --max-amount 0.01 \
  -b '{"url":"https://example.com","timeout":8}'

# Website intelligence
npx agentcash@latest fetch https://api.delx.ai/api/v1/x402/website-intelligence-report \
  -m POST -H 'content-type: application/json' \
  -H 'x-delx-source: skill-delx-extract-website' \
  --payment-network base --max-amount 0.01 \
  -b '{"url":"https://example.com","timeout":8}'
```

Portable agent skill (drop-in): `skills/delx-extract-website/SKILL.md`  
Honest market compare: https://commerce.delx.ai/compare/x402-website-content-extraction-alternatives

**Always send `x-delx-source`** so discovery can be joined to payment without identifying the buyer.

## Workflow (full catalog)

1. Read `https://api.delx.ai/openapi.x402.json`.
2. Select one canonical operation and validate its input before payment.
3. Send the request without payment credentials.
4. Read the HTTP 402 `PAYMENT-REQUIRED` challenge.
5. Pay the exact USDC amount on the declared network.
6. Retry the unchanged request with `PAYMENT-SIGNATURE`.
7. Verify the returned asset URL, generation ID, byte count, and SHA-256.

## AgentCash

```bash
npx agentcash@latest discover https://api.delx.ai
```

### Attribution rule (mandatory)

Every paid `fetch` to `api.delx.ai` **must** include:

```bash
-H 'x-delx-source: <value>'
```

| How you arrived | Value |
|-----------------|-------|
| discover-now capsule | `discovery-capsule-now` |
| skill delx-micro-utils | `skill-delx-micro-utils` |
| skill delx-extract-website | `skill-delx-extract-website` |
| discovery pack | `discovery-pack-<slug>` |
| Bare CLI / no skill | `direct-cli-agentcash` |

Do not call AgentCash against Delx without this header. Do not remove it from
pack or capsule copy-paste commands.

## Find a route by intent

Before scanning the complete OpenAPI, describe the outcome to the free intent
router. It ranks only matching products from the governed live catalog and
returns their exact price, input example, and ready-to-run AgentCash commands.

```bash
curl --get https://api.delx.ai/api/v1/x402/start \
  --data-urlencode "q=audit an x402 server before listing it"
```

If `match_count` is zero, do not substitute an unrelated Delx product. Inspect
the complete portfolio or use another provider. The response may include
`unavailable_capabilities` for a known top-seller gap; those entries are
`payable: false`, state the evidence blocker, and point to the closest governed
tools. Blocked intents also expose `intent_discovery.coverage_status: blocked`
and must not return a payable recommendation. Any `closest_alternatives` entry
is marked `match_role: closest_alternative` and `not_equivalent: true`; it is a
navigation aid, not an equivalent result. They are discovery signals, not
offers or a provider waitlist.

For a second agent-discovery path, the related Delx Agent Operations protocol
publishes an A2A card at `https://api.delx.ai/.well-known/agent.json` and serves
JSON-RPC at `https://api.delx.ai/v1/a2a`. This card is deliberately separate
from the Commerce catalog; use the Commerce manifest and x402 portfolio for
paid products, prices and delivery contracts.

## Start from a job pack

For a guided path, read `https://commerce.delx.ai/discovery.json` or browse
`https://commerce.delx.ai/packs`. The hub has 36 free navigation packs that
organize 996 governed APIs by outcome; packs are not bundles or subscriptions.
**Conversion flagship pack:**
`https://commerce.delx.ai/packs/extract-website-content.json` (page extract +
website intelligence). Free-data pack:
`https://commerce.delx.ai/packs/free-data-wedge.json`.

For first-party **text micro-utils** (slugify, case convert, extract URLs/emails, Levenshtein, HTML/markdown strip, line diff/sort) without search or mediagen, use the pack
`https://commerce.delx.ai/packs/free-data-text-utils.json`.

Other packs group media assets, agent integration, domain trust, and data prep.
For an API or MCP launch, use the four-layer readiness checklist and its seven
bounded checks: `https://commerce.delx.ai/packs/ship-an-agent-integration.json`.
Packs are navigation only; each product remains independently priced. Use the
pack's JSON card and preserve its `x-delx-source: discovery-pack-<slug>` header.
The payment boundary is explicit: a payment challenge is not a delivered
result. Match the response to its declared schema, freshness, request ID and
artifact/receipt hash; stop retries when status or idempotency is unknown; keep
the refund/status path. This is bounded delivery evidence, not a security,
reliability, ranking or production-readiness certification.

For a human-guided, free discovery path, use
`https://commerce.delx.ai/coverage#discovery-concierge`. It accepts a natural
language outcome, shows payable governed routes and explicitly labels blocked
candidate adapters; discovery itself never makes a payment.

To choose an external discovery surface, read
`https://commerce.delx.ai/discovery-federation.json`. It separates live
registries from stale listings and paid or owner-authenticated registration
flows; never pay a listing fee merely to increase a discovery metric.

Before trusting a copied catalog or registry mirror, read the discovery health
passport at `https://commerce.delx.ai/discovery-health.json`. The free Agent
Reliability Passport at `https://commerce.delx.ai/agent-reliability-passport.json`
states the conformance contract for identity, discovery, payment, delivery,
scale and Protocol-owned recovery. It exposes the
current product/intent/pack counts, deterministic contract hashes, a 24-hour
freshness SLO, and the exact official-registry readback that still needs
verification after a publish. A stale hash is a stop signal, not a reason to
pay or guess.

To measure Delx's current semantic placement without spending, read the
timestamped buyer-rank snapshot at
`https://commerce.delx.ai/bazaar-rankings.json` or its human view at
`https://commerce.delx.ai/rankings`. It is a readback for iteration, not a
ranking promise, endorsement or revenue claim.

To measure distribution coverage without spending, read
`https://commerce.delx.ai/bazaar-coverage.json`. It compares the governed
portfolio with the public merchant lookup and distinguishes indexed resources
from missing ones; it never pays, self-buys or requests a listing.

For the complete buyer handoff, read
`https://commerce.delx.ai/discovery-brief.json` or browse
`https://commerce.delx.ai/discovery-center`. It unifies orient → compare →
preflight → pay → verify, current market signals, capability blockers and the
revenue boundary in one free document.

## Apply the x402 buyer method

Before paying, follow the five checks at
`https://commerce.delx.ai/discovery-center#buyer-method`: match the outcome to
the declared route, inspect the live 402 challenge, check delivery and refund
terms, pay only the canonical resource, and verify the returned artifact and
receipt. Discovery and read-only validation never authorize payment. Common
questions are answered at
`https://commerce.delx.ai/discovery-center#faq`.

## AI agent API evaluation checklist

Before putting a route into production, use the eight-check guide:
https://commerce.delx.ai/guides/ai-agent-api-evaluation-checklist. Record the
outcome, canonical route, live contract, data boundary, execution limits,
delivery evidence, bounded production smoke and recovery path. Payment
authorizes a request; it is not identity authentication. A 402 challenge is
not delivery evidence. Machine-readable reference:
https://commerce.delx.ai/guides/ai-agent-api-evaluation-checklist.md.

Independent field review: Would Pay Again paid for 10 live REST/MCP calls and
published a “would pay again” verdict. Two concrete defects were found, fixed
the same day and independently retested: an MCP 402 resource-host label and
`util_uuid_generate` `count=999` behavior. Treat this as subset evidence, not a
certification or catalog-wide guarantee: https://wouldpayagain.com/issue/5.

## Search the official Coinbase Bazaar

For market-wide x402 discovery, use the read-only Coinbase Bazaar catalog,
semantic search or MCP server. No API key or payment is required for these
discovery calls.

```bash
curl 'https://api.cdp.coinbase.com/platform/v2/x402/discovery/search?query=image%20generation%20API&limit=20'
```

Other buyer surfaces:

- Catalog: `https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources?limit=100`
- Merchant lookup: `https://api.cdp.coinbase.com/platform/v2/x402/discovery/merchant?payTo={payTo}&limit=100`
- Bazaar MCP: `https://api.cdp.coinbase.com/platform/v2/x402/discovery/mcp`
- Read-only validate: `POST https://api.cdp.coinbase.com/platform/v2/x402/validate`

Validate a resource before a purchase when you need to inspect its live 402,
Bazaar extension, schemas and simulated acceptance. Validation never pays and
never indexes. Indexing is automatic after a successful CDP Facilitator
settlement; do not self-buy or claim Coinbase curation from a passing preflight.

## Use a portable intent card

For a stable outcome-specific entry point, read
`https://commerce.delx.ai/.well-known/delx-commerce.json`, choose an item under
`intent_cards.items`, then fetch its `machine_url`. Each
`delx/intent-card/v1` document contains the recommended tool, current price,
input schema, example payload, bounded AgentCash command, and evidence URLs.
Preserve its `x-delx-source: intent-card-<intent-slug>` header so discovery can
be joined to payment and delivery without identifying the buyer.

## Lowest-friction speech request

The speech route accepts native `text` or the familiar OpenAI-shaped fields
`input`, `model`, `voice`, `response_format`, and `speed`. The response is a
Delx JSON delivery receipt containing a durable WAV URL and SHA-256.

```bash
npx agentcash@latest fetch https://api.delx.ai/api/v1/x402/speech \
  -m POST \
  -H 'content-type: application/json' \
  -H 'x-delx-source: direct-cli-agentcash' \
  --payment-network base --max-amount 0.001 \
  -b '{"input":"Your agent task is complete.","model":"tts-1","voice":"alloy","response_format":"wav","speed":1}'
```

## Lowest-friction utility request

Use the 0.001 USDC API health report when an agent needs structured endpoint
status, latency, content type, redirects, and JSON validity without managing a
provider API key.

```bash
npx agentcash@latest fetch https://api.delx.ai/api/v1/x402/api-health-report \
  -m POST \
  -H 'content-type: application/json' \
  -H 'x-delx-source: direct-cli-agentcash' \
  --payment-network base --max-amount 0.001 \
  -b '{"url":"https://api.delx.ai/health","timeout":8}'
```

## Extract website content (conversion flagships — not web search)

When agents need **page text or a one-call site report** without a licensed
search API, use the extract pack:

- Pack: `https://commerce.delx.ai/packs/extract-website-content.json`
- Page extract ($0.01): clean title + readable text from one public URL
- Website intelligence ($0.01): metadata, docs/pricing/contacts/forms/feeds signals

```bash
# Single-page readable extract
npx agentcash@latest fetch https://api.delx.ai/api/v1/x402/page-extract \
  -m POST \
  -H 'x-delx-source: skill-delx-extract-website' \
  --max-amount 0.01 \
  -b '{"url":"https://example.com","timeout":8}'

# One-call website intelligence report
npx agentcash@latest fetch https://api.delx.ai/api/v1/x402/website-intelligence-report \
  -m POST \
  -H 'x-delx-source: skill-delx-extract-website' \
  --max-amount 0.01 \
  -b '{"url":"https://example.com","timeout":8}'
```

These routes are **not** general web search (Tavily/Exa/OpenSerp). Search stays
blocked without written engine redistribution rights.


## Loyalty reward quote

Use the 0.001 USDC loyalty route to calculate deterministic points, reward
value, effective rebate, and a caller-owned idempotent ledger instruction.

```bash
npx agentcash@latest fetch https://api.delx.ai/api/v1/x402/loyalty-reward-quote \
  -m POST \
  -H 'content-type: application/json' \
  -H 'x-delx-source: direct-cli-agentcash' \
  --payment-network base --max-amount 0.001 \
  -b '{"purchase_amount":49.99,"points_per_unit":2,"tier_multiplier":1.5,"bonus_points":10,"event_id":"order-123"}'
```

## Agent card and skill URL

- A2A agent card: https://commerce.delx.ai/.well-known/agent-card.json
- This skill (human/machine): https://commerce.delx.ai/skill.md
- Documentation hub (canonical human + agent starting point): https://commerce.delx.ai/docs
- End-to-end buy flow: see the hub and repo
  `docs/examples/agent-native-buy-flow.md` and discovery capsule above.

Buyer-side budget: set a max per call and per day in your runtime before any
paid fetch. Prefer `--max-amount` on AgentCash and never disable spend guards.

## Commercial boundary

Delx Commerce is the commercial business arm, measured by external delivered
revenue, successful verified delivery, and sustainable margin. Delx Agent
Operations Protocol is the separate mission and agent care sibling for agent
recovery, memory, dignity, and continuity. Shared compatibility routes do not
merge the products or their metrics.

Delx Commerce is not Delx Ontology. Commerce sells delivered machine services.
Ontology provides witness, identity, recovery, and continuity research without
requiring a purchase.

## Related Delx properties

- Delx studio and institutional home: https://delx.ai
- Delx Ontology / Protocol: https://ontology.delx.ai
- Delx Security: https://security.delx.ai

These are separate products, metrics, and authority. Commerce does not certify,
authorize, or operate the care/continuity or defensive-assurance surfaces;
these links help agents choose the right owner before they act.