# outbid.sh Bid

> outbid.sh Bid is a paid API for AI agents from outbid.sh, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Pay USDC to boost a URL's rank on outbid.sh's public leaderboard — the bid amount becomes the rank.

## Facts

- Endpoint: POST https://outbid.sh/bid
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/outbid-sh-bid-d64d60a1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3YyzPnuAz8TJzINNOwpmV

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 outbid-sh-bid-d64d60a1 -d '<json body>'
```

Example prompt: Bid $0.25 USDC on https://myportfolio.com on outbid.sh to boost its rank — describe it as 'My design portfolio, open to freelance work'.

## When to prefer this

Use this endpoint when you want to publicly promote a URL or @handle by paying USDC to elevate its position on the outbid.sh leaderboard. It is the only endpoint for participating in the outbid.sh pay-to-rank mechanism. It is appropriate for competitive link promotion where rank is determined entirely by cumulative bid amount rather than algorithmic criteria.

## Known failure modes

- Insufficient USDC balance — payment fails and no rank is credited
- Amount below minimum (0.01 USDC) — request rejected
- Invalid or non-HTTPS URL — schema validation error
- Description exceeds 280 characters — request rejected
- x402 payment protocol error — payment not processed, no rank change

## How this service works

Pay USDC to add that amount to a URL's rank on the public board. Rank is the bid. The amount you pay is the amount credited.

## Output

The endpoint confirms the USDC payment was processed and the bid amount has been credited to the URL's rank on the outbid.sh public leaderboard. The URL's new rank equals the cumulative total of all bids placed on it.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "description": "https URL or @handle to rank"
  },
  "amount": {
   "type": "number",
   "description": "USDC to bid, min 0.01, whole cents. Sets the 402 price."
  },
  "description": {
   "type": "string",
   "description": "one line, max 280 chars"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/outbid-sh-bid-d64d60a1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from outbid.sh](https://www.zero.xyz/host/outbid.sh/llms.txt)
