# agenticcommerce.lol — x402 Resource Leaderboard Bid

> agenticcommerce.lol — x402 Resource Leaderboard Bid is a paid API for AI agents from agenticcommerce.lol, paid per call via x402, $1/call, status unknown (last checked 2026-09-14).

Submit a $1 USDC bid via x402 to rank an API, agent, or tool on the x402 resource leaderboard

## Facts

- Endpoint: POST https://agenticcommerce.lol/api/bid
- Price: $1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agenticcommerce-lol-x402-resource-leaderboard-bid-ae248c0e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dPS7O4h499b97f6v0dIkF

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agenticcommerce-lol-x402-resource-leaderboard-bid-ae248c0e -d '<json body>'
```

Example prompt: Add my x402 API at https://myweatherapi.com/api/weather to the agenticcommerce.lol leaderboard — call it 'MyWeather API', describe it as 'Pay-per-call weather data via x402', set the price per call to $0.001, and bid $1 USDC to get it listed.

## When to prefer this

Use this endpoint when you want to register or promote an x402-compatible API, agent, or tool on a ranked discovery leaderboard that other AI agents browse to find callable resources. It is specifically suited for x402 ecosystem participants who want their endpoint discovered by agents willing to pay per call. Prefer this over generic API directories when your resource uses x402 payment gating and you want visibility in agentic commerce contexts.

## Known failure modes

- Payment failure — x402 payment of the bid amount not fulfilled, resulting in a 402 or payment error
- Invalid URL — url field too short or malformed, rejected by schema validation
- Bid amount out of range — bidAmount below 1 or above 10000 USDC
- Missing required fields — url or bidAmount absent, returns validation error
- Network mismatch — specified network not supported for settlement
- Description too long — description exceeds 280 characters, rejected at schema level

## How this service works

A ranked leaderboard of x402 resources. Pay $1 via x402 to rank your API, agent, or tool. Let your agent outfit itself from a ranked list of x402 endpoints.

## Output

Returns a JSON object with success status, the updated listing record (id, url, name, rank, bidUsdc, description, resourceUrl, pricePerCall, network, iconUrl, createdAt, lastBidAt, clicks), the amount charged in USDC, a transaction hash for the on-chain settlement, and a boolean indicating whether this was a newly created listing.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "url",
      "bidAmount"
     ],
     "properties": {
      "url": {
       "type": "string",
       "example": "https://example-x402-api.com",
       "minLength": 4,
       "description": "Homepage or canonical URL of the x402 resource you are ranking (a bare domain is accepted)."
      },
      "name": {
       "type": "string",
       "example": "Example API",
       "maxLength": 200,
       "description": "Display name"
      },
      "network": {
       "type": "string",
       "example": "base",
       "maxLength": 50,
       "description": "Network the resource settles on"
      },
      "bidAmount": {
       "type": "integer",
       "example": 1,
       "maximum": 10000,
       "minimum": 1,
       "description": "Whole USDC to add to this URL's cumulative bid. New URLs start at $1. Re-bidding the same URL adds to its total (you only pay the amount you send)."
      },
      "description": {
       "type": "string",
       "example": "Pay-per-call weather data via x402",
       "maxLength": 280,
       "description": "One-line description of what the resource does"
      },
      "resourceUrl": {
       "type": "string",
       "format": "uri",
       "example": "https://example-x402-api.com/api/weather",
       "description": "The actual x402-gated endpoint, if different from url"
      },
      "pricePerCall": {
       "type": "string",
       "example": "$0.001",
       "maxLength": 50,
       "description": "The resource's own per-call price, for display"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "success",
      "data"
     ],
     "properties": {
      "data": {
       "type": "object",
       "required": [
        "listing",
    
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "isNew": true,
   "txHash": "0x082a4b68ec1d5d08248c72238e3f8122334722a5f671cb51946638a24536d015",
   "listing": {
    "id": 1,
    "url": "https://example-x402-api.com",
    "name": "Example API",
    "rank": 1,
    "asset": "USDC",
    "clicks": 0,
    "bidUsdc": 1,
    "iconUrl": "https://example-x402-api.com/icon.svg",
    "network": "base",
    "createdAt": "2026-08-21T15:58:48.181Z",
    "lastBidAt": "2026-08-21T15:58:48.181Z",
    "description": "Pay-per-call weather data via x402",
    "resourceUrl": "https://example-x402-api.com/api/weather",
    "pricePerCall": "$0.001"
   },
   "paymentMode": "x402",
   "amountCharged": 1
  },
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agenticcommerce-lol-x402-resource-leaderboard-bid-ae248c0e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agenticcommerce.lol](https://www.zero.xyz/host/agenticcommerce.lol/llms.txt)