Bid Endpoints

Endpoints for querying individual bids and a bidder's full bid history across all auctions.

Get Bid Detail

GET /api/bids/:pubkey

Returns full detail for a single bid, including computed status fields and the associated auction's clearing price.

Path Parameters

Parameter	Type	Description
pubkey	string	Base58-encoded bid account public key

Example

curl https://cca-indexer-production.up.railway.app/api/bids/BidPubkey123...

Response

{
  "pubkey": "BidPubkey123...",
  "auction_config_pubkey": "AbC123...",
  "bid_id": "0",
  "owner": "XyZ789...",
  "max_price": "158456325028528675187087",
  "raw_amount": "1000000",
  "amount_q96": "...",
  "start_slot": "312050000",
  "start_auction_block": "5",
  "start_cumulative_mps": "1000",
  "exited_slot": "0",
  "tokens_filled": "500000",
  "currency_spent": "250000",
  "base_mint": "BaseMint123...",
  "quote_mint": "QuoteMint456...",
  "floor_price": "79228162514264337593544",
  "current_clearing_price": "158456325028528675187087",
  "is_eligible": true,
  "is_exited": false,
  "is_claimable": true
}

Computed Fields

Field	Description
is_eligible	true if max_price >= current_clearing_price
is_exited	true if exited_slot != 0
is_claimable	true if tokens_filled > 0 and bid has not been exited
current_clearing_price	The auction's current clearing price (from auction state)
base_mint	The auction's base token mint (from auction config)
quote_mint	The auction's quote token mint (from auction config)
floor_price	The auction's floor price (from auction config)

Returns 404 if the bid is not found.

---

Get Bidder's Bids

GET /api/bidder/:address/bids

Returns all bids placed by a specific wallet address across all auctions, ordered by start slot descending (newest first).

Path Parameters

Parameter	Type	Description
address	string	Base58-encoded wallet address of the bidder

Query Parameters

Parameter	Type	Default	Description
cursor	string	none	Pagination cursor from previous response
limit	number	20	Items per page

Example

# All bids by a wallet
curl "https://cca-indexer-production.up.railway.app/api/bidder/XyZ789.../bids"

# Paginated
curl "https://cca-indexer-production.up.railway.app/api/bidder/XyZ789.../bids?limit=10"

Response

Each bid includes the same computed fields as the single bid endpoint (is_eligible, is_exited, is_claimable), plus auction context (base_mint, quote_mint, floor_price, current_clearing_price).

{
  "data": [
    {
      "pubkey": "BidPubkey123...",
      "auction_config_pubkey": "AbC123...",
      "bid_id": "0",
      "owner": "XyZ789...",
      "max_price": "158456325028528675187087",
      "raw_amount": "1000000",
      "tokens_filled": "500000",
      "is_eligible": true,
      "is_exited": false,
      "is_claimable": true,
      "base_mint": "BaseMint123...",
      "quote_mint": "QuoteMint456...",
      "current_clearing_price": "158456325028528675187087"
    }
  ],
  "next_cursor": "...",
  "has_more": false
}

tip

Use this endpoint to build a portfolio view showing all of a user's bids across every auction they have participated in.