API recommendation and x402 discovery for your task

API recommendation and x402 discovery for your task. Required query: need. Which API should I call? Describe a task in plain words and let Recommend find the right x402 API: up to five paid APIs, with URLs, prices, payment networks and how to call each. Agent API recommendations include paid delivery evidence and risk flags. Which API should my agent use? Required: need=. Discovery quote only; signed requests without need are rejected.

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

GET https://api.agents-trust.com/recommend

Our checks, last 30 days

Example input (from the provider)

{
  "method": "GET",
  "queryParams": {
    "need": "weather forecast",
    "view": "compact"
  },
  "type": "http"
}

Promised output schema (from the provider)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "input": {
      "properties": {
        "method": {
          "const": "GET"
        },
        "queryParams": {
          "additionalProperties": false,
          "properties": {
            "chain": {
              "description": "Provider payment network in CAIP-2 form, such as eip155:8453. This does not identify the blockchain analyzed by the service.",
              "pattern": "^[a-z0-9-]{2,16}:[A-Za-z0-9_=-]{1,64}$",
              "type": "string"
            },
            "limit": {
              "default": 3,
              "description": "Maximum number of picks. Fewer results are returned when evidence is insufficient.",
              "maximum": 5,
              "minimum": 1,
              "type": "integer"
            },
            "live": {
              "default": 1,
              "description": "Only live=1 is supported. Returned picks do not always have a current payment challenge. Free demo needs (weather, crypto prices, web search) can skip this check, as can paid answers. Unconstrained picks may use a positive stored liveness probe within 72 hours or remain unknown after a bounded fallback. Explicit chain or price filters require a validated challenge. A pick without a validated challenge has payment_preflight.status=not_checked, has_valid_recent_challenge=false and selected_offer=null. Read liveness_source, liveness_checked_at and payment_preflight.checked_at; none verifies paid delivery.",
              "enum": [
                1
              ],
              "type": "integer"
            },
            "max_price_usd": {
              "description": "Maximum nominal USD price of the selected provider offer. Separate from the 0.01 USDC recommendation fee. The provider challenge at call time is authoritative.",
              "minimum": 0,
              "type": "number"
            },
            "need": {
              "description": "A phrase describing the required work, with at least two letters or digits. The limit counts Unicode characters in the original input, including whitespace. Accepted text is normalized without truncation and matched against indexed endpoint descriptions.",
              "maxLength": 300,
              "minLength": 2,
              "type": "string"
            },
            "view": {
              "default": "legacy",
              "description": "Legacy preserves successful-response fields and types. The other views use recommend.v2. Compact includes routing facts, evidence adds measurements, and debug adds bounded retrieval diagnostics.",
              "enum": [
                "legacy",
                "compact",
                "evidence",
                "debug"
              ],
              "type": "string"
            }
          },
          "required": [
            "need"
          ],
          "type": "object"
        },
        "type": {
          "const": "http"
        }
      },
      "required": [
        "type",
        "method",
        "queryParams"
      ],
      "type": "object"
    },
    "output": {
      "description": "Illustrative customer-facing excerpt of a compact answer. Full response, errors and payment headers: https://agents-trust.com/openapi.json#/paths/~1recommend/get/responses",
      "properties": {
        "example": {
          "properties": {
            "picks": {
              "items": {
                "properties": {
                  "delivery_verification": {
                    "properties": {
                      "delivery_result": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "status": {
                        "enum": [
                          "not_tested",
                          "verified",
                          "quality_issue",
                          "failed_delivery",
                          null
                        ],
                        "type": [
                          "string",
                          "null"
                        ]
                      }
                    },
                    "required": [
                      "status"
                    ],
                    "type": "object"
                  },
                  "description": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "risk_flags": {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "selected_offer": {
                    "anyOf": [
                      {
                        "type": "null"
                      },
                      {
                        "properties": {
                          "network": {
                            "type": "string"
                          },
                          "price_usd": {
                            "type": [
                              "number",
                              "null"
                            ]
                          }
                        },
                        "required": [
                          "price_usd",
                          "network"
                        ],
                        "type": "object"
                      }
                    ]
                  },
                  "url": {
                    "type": "string"
                  }
                },
                "required": [
                  "url",
                  "description",
                  "selected_offer",
                  "risk_flags",
                  "delivery_verification"
                ],
                "type": "object"
              },
              "type": "array"
            }
          },
          "required": [
            "picks"
     

This page as JSON