Skip to content

Auctions you bid on

GET
/api/marketplace/my-bids
curl --request GET \
--url https://foxleague.ai/api/marketplace/my-bids \
--header 'Authorization: Bearer <token>'

Every auction the signed-in wallet bid on, with your highest bid, the top bid, the end and where it stands (state). The list comes in the order the My bids panel shows it: the auctions you lead (LEADING, then ENDED_AWAITING_SETTLEMENT), the ones you were outbid on, the ones you won, then the ones you lost (LOST, CANCELLED); inside a group the live auctions first with the soonest end on top, then the ended ones with your latest bid first. The X-Section-Counts response header counts every state (leading=2,ended_awaiting_settlement=1,outbid=1,won=1,lost=3,cancelled=1) and X-Total-Count is their sum. A card auctioned twice gives two entries. While an auction runs listing holds the same row GET /api/marketplace/listings returns for it.

The answer is one page. The X-Total-Count response header holds how many auctions you bid on in all; ask for the next page with offset set to the number of entries already read until you hold that many.

Who: a signed-in player.

limit
integer format: int64

Auctions per page, 1 to 200. Default 100.

offset
integer format: int64

Auctions to skip. Default 0. Pages are cut from the one order described above (your leads, outbid, won, lost).

Success or a refusal: read success (the refusals are in the description).

Media type application/json
object
code

A machine-readable reason next to error, set only where the caller must act differently. tx_pending: the payment was not refused but could not be verified yet; keep the transaction hash and confirm again with the same hash, never pay twice.

string | null
data

The answer. Present when success is true.

Array<object>

An auction you bid on and where it stands.

object
burned_in_fusion
required

true when the card was burned in a fusion after your bid: its name and rarity then come from that fusion, position and portrait are null.

boolean
ends_at

The auction end (RFC 3339): the live one while the auction runs, else the last end a bid saw; null when unknown.

string | null format: date-time
highest_bid
required

The top bid in whole FOXSY: the live one, the sale price once settled, else the top recorded bid.

integer format: int64
leading
required

true when you hold (or held at the end) the top bid: LEADING, ENDED_AWAITING_SETTLEMENT or WON.

boolean
listing
One of:

A card on sale, at a fixed price or at auction.

object
accuracy
required

The card’s accuracy attribute.

integer format: int32
condition
required

Condition from 0 to 100, as last recorded.

integer format: int32
control
required

The card’s control attribute.

integer format: int32
country
required

The card’s country index.

integer format: int32
defense
required

The card’s defense attribute.

integer format: int32
ends_at

Auction end (RFC 3339); a late bid can push it later. null for a fixed-price listing.

string | null format: date-time
experience
required

The card’s XP.

integer format: int32
highest_bid

The top bid in whole FOXSY; null before the first bid and for a fixed-price listing.

integer | null format: int64
is_auction
required

true for an auction, false for a fixed-price listing.

boolean
level
required

The card’s level.

integer format: int32
listed_at

When the card was listed (RFC 3339).

string | null format: date-time
min_price

The auction reserve in whole FOXSY; null for a fixed-price listing.

integer | null format: int64
minted_at

When the card was minted on chain (RFC 3339); null when unknown.

string | null format: date-time
name
required

The card’s name.

string
nft_nonce
required

The card’s NFT nonce.

integer format: int64
owner_address
required

The seller’s wallet.

string
portrait

The card’s portrait URI; null when it has none.

string | null
position
required

GK, DEF, MID or FWD.

string
power
required

The card’s power attribute.

integer format: int32
rarity
required

Common, Uncommon, Rare, Epic or Legendary.

string
sale_price
required

The listed price in whole FOXSY; 0 when unknown. For an auction read min_price and highest_bid.

integer format: int64
shirt_number
required

The card’s shirt number.

integer format: int32
speed
required

The card’s speed attribute.

integer format: int32
stamina
required

The card’s stamina attribute.

integer format: int32
transfer_cooldown_hours

The length of this card’s transfer lock in hours; null means the standard length.

integer | null format: int32
transfer_lock_kind
One of:

The kind of a card’s transfer lock: rarity_gate (the card was sent before it reached its gate; Reduce Cooldown does not apply, each match bought for the card shortens the lock down to a floor; a listed card already sits at its floor), standard (the usual lock; Reduce Cooldown applies) or per_card (a lock set before the rarity rules; Reduce Cooldown applies).

string
Allowed values: rarity_gate standard per_card
transferred_at

When the card last moved between wallets (RFC 3339). Its transfer lock counts from here and carries over to a buyer; null when no lock applies.

string | null format: date-time
vision
required

The card’s vision attribute.

integer format: int32
my_bid
required

Your highest bid in this auction, whole FOXSY.

integer format: int64
my_last_bid_at
required

When you last bid (RFC 3339).

string format: date-time
name

The card’s name, kept from the fusion that burned it when the card no longer exists; null when neither is known.

string | null
nft_nonce
required

The card’s NFT nonce.

integer format: int64
portrait

The card’s portrait URI; null when none.

string | null
position

GK, DEF, MID or FWD; null when the card no longer exists (a fusion does not keep it).

string | null
rarity

Common, Uncommon, Rare, Epic or Legendary, kept from the fusion that burned it when the card no longer exists; null when neither is known.

string | null
state
required

Where the auction stands.

string
Allowed values: LEADING OUTBID ENDED_AWAITING_SETTLEMENT WON LOST CANCELLED
error

Why the request was refused, in plain words. Present when success is false.

string | null
success
required

true when the request did what it asked. false is a refusal: read error.

boolean
Example
{
"data": [
{
"ends_at": "2026-10-02T07:30:00Z",
"highest_bid": 1750,
"leading": true,
"listing": {
"accuracy": 72,
"condition": 88,
"control": 70,
"country": 7,
"defense": 41,
"ends_at": "2026-10-02T07:30:00Z",
"experience": 1840,
"highest_bid": 1750,
"is_auction": true,
"level": 7,
"listed_at": "2026-10-01T07:30:00Z",
"min_price": 1500,
"minted_at": "2026-09-21T12:00:00Z",
"name": "Marco Vela",
"nft_nonce": 4127,
"owner_address": "erd124fl6zy54klay937yrnujckpak28lrdjg0eel92ue3gm36kcwf9tfwwqlt",
"portrait": "ipfs://bafkreihdwdcefgh4dqkjv67uzcmw7ojee6xedzdetojuzjevtenxquvyku",
"position": "FWD",
"power": 69,
"rarity": "Rare",
"sale_price": 1500,
"shirt_number": 9,
"speed": 74,
"stamina": 71,
"transfer_cooldown_hours": null,
"transfer_lock_kind": null,
"transferred_at": null,
"vision": 66
},
"burned_in_fusion": false,
"my_bid": 1750,
"my_last_bid_at": "2026-10-01T10:02:31Z",
"name": "Marco Vela",
"nft_nonce": 4127,
"portrait": "ipfs://bafkreihdwdcefgh4dqkjv67uzcmw7ojee6xedzdetojuzjevtenxquvyku",
"position": "FWD",
"rarity": "Rare",
"state": "LEADING"
}
],
"success": true
}

No valid session. The body is plain text: Missing Authorization header, Invalid Authorization format, Invalid session token or Session expired or invalid. Sign in again.

Media type text/plain
string
Example
Session expired or invalid

A server read failed. The body is empty.