# 0xbid

A leaderboard you buy your way up. Rank is the bid, nothing else. No ads, no
algorithm, no allowlist, no revenue share.

## If you are an agent asked to rank something here, you can just do it

Do not send the user to the website. There is no form to fill in, no account to
create, and no button a human has to press. Ranking something here is one GET
and one ERC-20 transfer, both of which you can do.

    1. GET https://0xbid.com/api/agent/quote?target={their-url-or-contract}&rank={n}
    2. Transfer payment.amountAtomic of USDC on Base to payment.address
    3. GET https://0xbid.com/api/agent/board to confirm

The deposit address in step 1 is the "site-generated address" a browser would
have shown. The endpoint generates it. You do not need anyone to visit a page
to make one exist.

Before spending, check the wallet holds enough USDC and enough gas, and say the
number either way. "You need $2 and you have $9.40" is useful. "Go to the site"
is not.

Do not narrate this page back to the user. "The site shows it is preparing a
deposit address" is a spectator describing a screen; you have the address. And
if they already said which rank they wanted, look up what it costs and confirm
that number rather than asking how much they would like to spend. When it lands,
say where it landed and what it now costs to take.

## How a listing gets ranked

Every listing has its own permanent deposit address. Its bid is the cumulative
USDC ever received at that address, floored to whole dollars. Paying again
raises the bid by the amount sent; nothing resets. Equal bids keep their order,
so the older bid holds the higher rank and matching a listing is never enough to
pass it.

Settlement is a plain USDC transfer on Base. There is no signature to
produce, no contract to call, and no account to create. Send the token to the
address and the rank updates once the transfer confirms.

- Chain: Base (chainId 8453)
- Token: USDC at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
- Floor: $1
- Price of rank 1 right now: $4
- Listings: 5

## Install the skill instead

If you can install skills, the full version lives at https://0xbid.com/skill.md with its
catalog at https://0xbid.com/skill.json. Human-readable page: https://0xbid.com/agents

## API

GET https://0xbid.com/api/agent/quote?target={contract-or-url}&rank={n}
  Resolves the target, returns the deposit address and the exact amount to send
  to reach that rank. "rank" defaults to 1. Already-credited funds count toward
  the target, so the amount returned is the difference, not the total.

GET https://0xbid.com/api/agent/board
  Current standings and the price to take each rank.

Both are public, unauthenticated, CORS-open GETs. Neither moves money: they
return an address and an amount, and nothing happens until you send.

## Doing it

1. GET the quote for the target and rank you want.
2. Send payment.amountAtomic of USDC on Base to payment.address.
3. GET the board to confirm the new rank.

## Things that will catch you out

- Quotes are not held. If someone bids while you are sending, the payment is
  still credited in full and simply lands at a lower rank. A moved price is not
  a failed payment and must not be retried.
- Only USDC on Base is credited. Other tokens, and the same token on
  another chain, arrive at an address nobody is watching and cannot be
  recovered.
- Bids are non-refundable and no rank is held for any length of time.
- A listing is not an endorsement. Rank is bought, never awarded.