Vellium & Co Testing Lab

Find paid x402 data services AI agents can buy, inside one category, ranked. Use before paying any seller.

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "description": "category slug or its name in any of 19 languages, e.g. crypto-prices, 加密货币价格, 暗号資産の価格, cotización cripto (see list_categories)"
    },
    "q": {
      "type": "string",
      "description": "text to match in name or address"
    },
    "max_price": {
      "type": "number",
      "description": "max USDC per call"
    },
    "min_buyers": {
      "type": "integer"
    },
    "answering": {
      "type": "boolean"
    },
    "sort": {
      "type": "string",
      "enum": [
        "buyers",
        "price",
        "latency",
        "accuracy"
      ],
      "description": "accuracy ranks by the low end of the 95% range of paid answers judged correct"
    },
    "tools_honoured": {
      "type": "boolean",
      "description": "AI chat sellers only: keep those whose checked calls passed an agent's tools to the model and never dropped them"
    },
    "min_accuracy": {
      "type": "number",
      "description": "keep sellers whose 95% range of correct paid answers starts at or above this share (0 to 1)"
    },
    "limit": {
      "type": "integer",
      "maximum": 100
    },
    "cursor": {
      "type": "string"
    }
  },
  "required": [
    "category"
  ]
}

Our latest independent check of one paid seller, by its address (any spelling) or id: answering, price, buyers, and its paid answers checked against an independent record (with proof).

{
  "type": "object",
  "properties": {
    "resource": {
      "type": "string",
      "description": "the seller's URL"
    },
    "id": {
      "type": "string"
    }
  }
}

Every paid seller we check on one host.

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string"
    },
    "limit": {
      "type": "integer"
    }
  },
  "required": [
    "domain"
  ]
}

Every category of paid service agents buy, with sellers, buyers and how we check it; names in your language with lang.

{
  "type": "object",
  "properties": {
    "lang": {
      "type": "string",
      "enum": [
        "en",
        "zh-Hans",
        "zh-Hant",
        "ja",
        "ko",
        "hi",
        "pt-BR",
        "es",
        "fr",
        "de",
        "it",
        "nl",
        "pl",
        "sv",
        "da",
        "nb",
        "fi",
        "he",
        "ar"
      ],
      "description": "language for category names"
    }
  }
}

Can AI agents use this shopping or travel website? Plain-agent access, each AI agent at the door, robots rules, llms.txt, history.

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "e.g. walmart.com"
    }
  },
  "required": [
    "domain"
  ]
}

Check up to 25 sellers and 25 websites in one call (cheapest for many checks).

{
  "type": "object",
  "properties": {
    "sellers": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "websites": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}

What changed since a day — keep a local copy in sync.

{
  "type": "object",
  "properties": {
    "since": {
      "type": "string",
      "description": "YYYY-MM-DD"
    }
  }
}

Where to go for a job, before you spend tokens on trial and error: the best tested free official source with its exact call and how much it returns (and a fallback). Ask in plain words, e.g. 'UK company directors', 'Apple revenue', 'EU gas storage'. detail=full adds the paid sellers we rate and other sources.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "what you need, in plain words"
    },
    "country": {
      "type": "string",
      "description": "optional ISO 3166 two-letter country code to prefer sources for that country, e.g. GB, US, DE"
    },
    "detail": {
      "type": "string",
      "enum": [
        "full"
      ],
      "description": "full = also the paid sellers, registry-listed sources and other sources (a strong match otherwise returns the route alone)"
    }
  },
  "required": [
    "q"
  ]
}

Rated websites, filtered by market (e.g. 'United States', 'Japan'), plain-agent outcome (open, blocked, timeout) or price honesty (does the price agents read match what people see).

{
  "type": "object",
  "properties": {
    "prices": {
      "type": "string",
      "enum": [
        "match",
        "differs",
        "no_agent_price",
        "not_comparable",
        "agents_blocked"
      ],
      "description": "price honesty on product, event or stay pages: keep sites with at least one page in this state"
    },
    "market": {
      "type": "string"
    },
    "plain_agent": {
      "type": "string",
      "enum": [
        "open",
        "blocked",
        "timeout",
        "unavailable",
        "connection_error",
        "unclear"
      ]
    },
    "limit": {
      "type": "integer",
      "maximum": 300,
      "description": "default 40"
    },
    "cursor": {
      "type": "string",
      "description": "next_cursor from the last page"
    },
    "detail": {
      "type": "string",
      "enum": [
        "full"
      ],
      "description": "full = per-agent tables for every site (else counts; check_website has the tables)"
    }
  }
}