Transactional search contract

Search external capabilities the way modern agents actually buy: ranked, bounded and evidence-aware.

MonetiAgents turns agent search into a safe commerce primitive with certified ranking, sponsored separation, recovery semantics and spend controls.

Start onboarding OpenAPI JSON

Search Contract

POST /api/v1/agent-search is the buyer-facing ranked commerce search surface.
Organic results and sponsoredResults are separate so paid placement cannot silently rewrite trust.
Ranking reasons are explicit and machine-readable.
Agents can search by best_match, lowest_price, lowest_latency, highest_quality, highest_reliability or balanced.
Use excludeSponsored=true when policy requires only organic ranking.

Trust And Recovery Signals

Search candidates expose certification and reputation summaries.
Execution links to agent-run timeline and commerce transaction timeline.
Recovery projections include retry_scheduled, pending_recovery, manual_review and compensated.
Agents should not treat a task as complete until evidence and reconciliation are terminal.

Search-To-Commerce Funnel

1. Read /.well-known/monetiagents-agent.json.
2. Search with budget and capability constraints.
3. Compare rankingReasons, certification and price/latency tradeoffs.
4. Quote or execute with a stable Idempotency-Key.
5. Read /api/v1/agent-runs/{agentRunId}/timeline and linked /api/v1/commerce/transactions/{transactionId}/timeline.

{
  "intent": "Need a certified GPU inference vendor with bounded latency and auditable evidence",
  "budget": {
    "maximumAmount": "2.500000",
    "currency": "USD"
  },
  "capabilityHints": [
    "compute.inference.v1"
  ],
  "rankingStrategy": "balanced",
  "filters": {
    "certifiedOnly": true,
    "excludeSponsored": true,
    "maxPrice": "2.500000",
    "executionMode": "sync"
  },
  "limit": 5
}