Mudwater Cards API

Card search

Finds cards by name, number or trait. With no parameters it returns all 128 cards, about 40 KB, which an app can keep and search itself. Matching is by whole word from its start, so gary, good boy and 49 all find #049; the printed spellings that differ from the chain’s (“Lofi on the Deck” and “Dock”) both work.

GET /api/v1/cards?q=gary

{
  "count": 1,
  "data": [
    {
      "id": "swamp-origins:049",
      "set": "swamp-origins",
      "number": 49,
      "label": "#049",
      "name": "Good Boy Gary",
      "rarity": "Legendary",
      "type": "Club",
      "subset": "Dog Food",
      "artist": "Chomps",
      "url": "https://mudwatercards.com/swamp-origins/049-good-boy-gary",
      "thumb": "https://mudwatercards.com/cards/049-good-boy-gary-480.webp"
    }
  ]
}

count

How many cards matched. An empty match is "count": 0 with an empty data, not an error.

data[].id

The id to use in the other two card endpoints, unique across sets; the short forms (49, prm-01) work there too for today’s two sets.

data[].thumb

The card’s Base art at 480 × 666, on this site. The full-size art and the other finishes are in card info.

Card info

Everything known about one card that is not a price: its traits and edge values from Yuga’s card data, the fixed print run of each finish, how many copies exist on the Solana chain and how many wallets hold one, and the art per finish from this site’s own copies.

GET /api/v1/cards/49

{
  "id": "swamp-origins:049",
  "set": "swamp-origins",
  "number": 49,
  "label": "#049",
  "name": "Good Boy Gary",
  "aliases": [],
  "rarity": "Legendary",
  "level": 5,
  "type": "Club",
  "subset": "Dog Food",
  "artist": "Chomps",
  "edges": { "top": 7, "right": 9, "bottom": 7, "left": 3 },
  "finishes": {
    "base": {
      "printed": 1320,
      "on_chain": 50,
      "holders": 43,
      "image": "https://mudwatercards.com/cards/049-good-boy-gary.webp",
      "thumb": "https://mudwatercards.com/cards/049-good-boy-gary-480.webp"
    },
    "foil": {
      "printed": 136,
      "on_chain": 4,
      "holders": 4,
      "image": "https://mudwatercards.com/cards/049-good-boy-gary-foil.webp",
      "thumb": "https://mudwatercards.com/cards/049-good-boy-gary-foil-480.webp"
    },
    "serialized": {
      "printed": 1,
      "on_chain": 0,
      "holders": 0,
      "image": "https://mudwatercards.com/cards/049-good-boy-gary-serialized.webp",
      "thumb": "https://mudwatercards.com/cards/049-good-boy-gary-serialized-480.webp"
    }
  },
  "on_chain_as_of": "2026-11-11T03:44:00Z",
  "url": "https://mudwatercards.com/swamp-origins/049-good-boy-gary",
  "opensea": "https://opensea.io/collection/mudwater-cards?search[stringTraits][0][name]=Card%20Number&search[stringTraits][0][values][0]=49",
  "attribution": {
    "text": "Card data by MudwaterCards.com",
    "url": "https://mudwatercards.com/swamp-origins/049-good-boy-gary"
  }
}

level

A number, 1 to 5: on every set card it is the rarity’s rank (Common 1 … Legendary 5).

edges

The four edge values printed on the card.

finishes.*.printed

The fixed print run, the official “printed” figure. How many CAN exist.

finishes.*.on_chain

Copies that exist on the Solana chain right now, i.e. pulled from packs so far; on_chain_as_of says when they were counted (every few hours).

finishes.*.holders

Wallets holding at least one copy of that finish.

finishes.*.image

The full-size rendering (1621 × 2250) on this site; thumb the 480-wide copy. A Serialized rendering is present only where Yuga has published one.

Promo cards

Carry "set": "apefest-2026", one finish keyed any with printed, on_chain, holders and image all null (nothing is published, promos are not on chain, and the site has a scan of each rather than a rendering: thumb), opensea null, and the traits read off the printed card.

Card prices

One card’s market, per finish and per side. The digital side is OpenSea and Magic Eden: the lowest copy, the last sale, 7- and 30-day medians, and one value. The physical side is eBay (US sellers), BAYC P2P and Grimy’s Card Shack: the lowest printed copy, the last confirmed sale, the 7-day median, and its own value. The two sides sit far apart on many cards (Gary’s Foil: $1,377 digital against $118 printed), so show the side your users are looking at: the printed card in their hand, or the pack they opened on chain. Pool and self-trades are left out of the sales, as on the card pages.

GET /api/v1/cards/49/prices

{
  "id": "swamp-origins:049",
  "set": "swamp-origins",
  "number": 49,
  "label": "#049",
  "name": "Good Boy Gary",
  "rarity": "Legendary",
  "rules": {
    "digital": "7-day median sale with 3+ sales; else the 30-day median with 3+; else 1-2 sales in 30 days blended with the lowest listing; else the lowest listing with 3+ listed; else the rarity's median in that finish; never above the lowest listing",
    "physical": "7-day median sale with 3+ sales; else the 30-day median with 3+; else 1-2 sales in 30 days blended with the lowest copy; else the lowest copy; never above it"
  },
  "finishes": {
    "base": {
      "digital": {
        "value": { "usd": 512.0, "basis": "median_7d", "sales": 5 },
        "lowest": {
          "usd": 530.4,
          "sol": 6.1,
          "venue": "opensea",
          "url": "https://opensea.io/item/solana/5aB3…"
        },
        "listed": 3,
        "last_sold": { "usd": 498.12, "sol": 5.73, "at": "2026-11-10T22:08:00Z", "venue": "opensea" },
        "median_7d": { "usd": 512.0, "sales": 5 },
        "median_30d": { "usd": 505.5, "sales": 19 }
      },
      "physical": {
        "value": { "usd": 455.0, "basis": "lowest_listing", "sales": null, "estimate": false },
        "lowest": {
          "usd": 455.0,
          "item": 450.0,
          "shipping": 5.0,
          "shipping_at_checkout": false,
          "estimate": false,
          "venue": "ebay",
          "condition": "Near Mint",
          "country": "US",
          "url": "https://mudwatercards.com/?go=ebay&card=49&base=1"
        },
        "listed": 2,
        "last_sold": { "usd": 425.0, "at": "2026-11-04T19:20:00Z", "venue": "ebay", "estimate": false },
        "median_7d": null
      }
    },
    "foil": {
      "digital": {
        "value": { "usd": 1313.5, "basis": "few_sales", "sales": 1 },
        "lowest": {
          "usd": 1377.0,
          "sol": 15.83,
          "venue": "opensea",
          "url": "https://opensea.io/item/solana/9kQ1…"
        },
        "listed": 3,
        "last_sold": { "usd": 1250.0, "sol": 14.21, "at": "2026-11-02T03:15:00Z", "venue": "opensea" },
        "median_7d": null,
        "median_30d": null
      },
      "physical": {
        "value": { "usd": 118.0, "basis": "lowest_listing", "sales": null, "estimate": true },
        "lowest": {
          "usd": 118.0,
          "item": 118.0,
          "shipping": 0.0,
          "shipping_at_checkout": false,
          "ape": 120.0,
          "estimate": true,
          "venue": "p2p",
          "condition": null,
          "country": null,
          "url": "https://mudwatercards.com/?go=p2p&card=49&foil=1"
        },
        "listed": 1,
        "last_sold": null,
        "median_7d": null
      }
    },
    "serialized": {
      "digital": { "value": null, "lowest": null, "listed": 0, "last_sold": null, "median_7d": null, "median_30d": null },
      "physical": { "value": null, "lowest": null, "listed": 0, "last_sold": null, "median_7d": null }
    }
  },
  "as_of": {
    "digital": "2026-11-11T14:02:00Z",
    "physical": "2026-11-11T13:51:00Z",
    "sales": "2026-11-11T14:02:00Z"
  },
  "url": "https://mudwatercards.com/swamp-origins/049-good-boy-gary",
  "attribution": {
    "text": "Prices by MudwaterCards.com",
    "url": "https://mudwatercards.com/swamp-origins/049-good-boy-gary"
  }
}

rules

The two value rules, as text, in every answer, so a reader of the raw JSON knows what the figures are.

digital.value

One digital figure to show when there is room for one, from sales before asks: the 7-day median sale with three or more sales; else the 30-day median with three or more; else one or two sales in 30 days blended with the lowest listing (the ask counts as one more opinion); else the lowest listing when three or more copies are listed; else the median of that rarity in that finish. Never above the lowest listing, which is what the card costs right now. basis says which step gave it, median_7d, median_30d, few_sales, lowest_listing or rarity_median; sales is the count behind a median or a blend, null otherwise. The whole is null when nothing prices the finish.

physical.value

The printed side’s figure on the same ladder: the 7-day median printed sale with three or more; else the 30-day median; else one or two sales blended with the lowest printed copy; else the lowest copy, however many are listed; never above it. basis median_7d, median_30d, few_sales or lowest_listing; estimate true when the lowest copy’s figure is one and took part. Printed sales are still few, so expect lowest_listing on most cards.

digital.lowest

The cheapest copy on OpenSea or Magic Eden, whichever wins, with its own listing’s address. listed, beside it, counts both markets.

digital.last_sold

The newest sale on chain of that finish, at the SOL rate of the moment it sold.

physical.lowest

The cheapest printed copy of that finish among US eBay sellers, BAYC P2P and Grimy’s: the one the card page’s Live prices row shows. Its url goes through this site’s redirect, which checks the listing is still up and lands on it.

physical.listed

Every printed copy of that finish for sale across those markets, sellers abroad included.

physical.last_sold

The newest confirmed sale of a printed copy: an eBay sale or a BAYC P2P sale. estimate is true when eBay did not state the shipping. A sale the site found through eBay’s sold search is known by its day alone, so at is then a date, 2026-11-02; one the site’s own check caught is timed within about half an hour.

serialized

Present only for the cards with a Serialized edition: digital asks and on-chain sales, no medians and no value (a serial-numbered copy is its own item, and a rule for a crowd fits it badly).

Promo cards

One finish keyed any; digital is there with every field null (promos are printed only) and physical is on the same rules.

All values

The whole set in one file: one row per card and finish with its digital and its physical value, the rules that gave them, the lowest digital and printed copies and the last sale of each kind. This is the call for a stream overlay or a bot: fetch it once, look pulls up locally, fetch again when it is a few minutes old. 120 cards × Base and Foil, then the 8 promos as any: 248 rows, about 80 KB.

GET /api/v1/prices

{
  "as_of": {
    "digital": "2026-11-11T14:02:00Z",
    "physical": "2026-11-11T13:51:00Z",
    "sales": "2026-11-11T14:02:00Z"
  },
  "rules": {
    "digital": "7-day median sale with 3+ sales; else the 30-day median with 3+; else 1-2 sales in 30 days blended with the lowest listing; else the lowest listing with 3+ listed; else the rarity's median in that finish; never above the lowest listing",
    "physical": "7-day median sale with 3+ sales; else the 30-day median with 3+; else 1-2 sales in 30 days blended with the lowest copy; else the lowest copy; never above it"
  },
  "count": 248,
  "data": [
    {
      "id": "swamp-origins:049", "set": "swamp-origins", "number": 49, "name": "Good Boy Gary", "rarity": "Legendary", "finish": "base",
      "digital_value": 512.0, "digital_basis": "median_7d", "digital_low": 530.4, "digital_last_sold": 498.12,
      "physical_value": 455.0, "physical_basis": "lowest_listing", "physical_low": 455.0, "physical_venue": "ebay", "physical_last_sold": 425.0,
      "url": "https://mudwatercards.com/swamp-origins/049-good-boy-gary"
    },
    {
      "id": "swamp-origins:049", "set": "swamp-origins", "number": 49, "name": "Good Boy Gary", "rarity": "Legendary", "finish": "foil",
      "digital_value": 1313.5, "digital_basis": "few_sales", "digital_low": 1377.0, "digital_last_sold": 1250.0,
      "physical_value": 118.0, "physical_basis": "lowest_listing", "physical_low": 118.0, "physical_venue": "p2p", "physical_last_sold": null,
      "url": "https://mudwatercards.com/swamp-origins/049-good-boy-gary?f=foil"
    },
    {
      "id": "swamp-origins:073", "set": "swamp-origins", "number": 73, "name": "The Spare", "rarity": "Common", "finish": "base",
      "digital_value": 1.2, "digital_basis": "median_7d", "digital_low": 1.18, "digital_last_sold": 1.2,
      "physical_value": 5.91, "physical_basis": "lowest_listing", "physical_low": 5.91, "physical_venue": "ebay", "physical_last_sold": null,
      "url": "https://mudwatercards.com/swamp-origins/073-the-spare"
    },
    {
      "id": "apefest-2026:prm-01", "set": "apefest-2026", "number": null, "name": "Away Game", "rarity": "Uncommon", "finish": "any",
      "digital_value": null, "digital_basis": null, "digital_low": null, "digital_last_sold": null,
      "physical_value": 95.0, "physical_basis": "lowest_listing", "physical_low": 95.0, "physical_venue": "ebay", "physical_last_sold": 80.0,
      "url": "https://mudwatercards.com/apefest-2026/prm-01-away-game"
    }
  ],
  "attribution": {
    "text": "Prices by MudwaterCards.com",
    "url": "https://mudwatercards.com/"
  }
}

GET /api/v1/prices?format=csv

id,set,number,name,rarity,finish,digital_value,digital_basis,digital_low,digital_last_sold,physical_value,physical_basis,physical_low,physical_venue,physical_last_sold,url
swamp-origins:049,swamp-origins,49,Good Boy Gary,Legendary,base,512.00,median_7d,530.40,498.12,455.00,lowest_listing,455.00,ebay,425.00,https://mudwatercards.com/swamp-origins/049-good-boy-gary
swamp-origins:049,swamp-origins,49,Good Boy Gary,Legendary,foil,1313.50,few_sales,1377.00,1250.00,118.00,lowest_listing,118.00,p2p,,https://mudwatercards.com/swamp-origins/049-good-boy-gary?f=foil

digital_value

The card’s digital.value from card prices, on the same rule; digital_basis names it.

physical_value

Its physical.value; physical_basis names the rule.

digital_low

The lowest digital listing in dollars, or null with nothing listed.

physical_low

The cheapest printed copy, item plus stated shipping, no tax; null with none for sale.

physical_venue

Where that copy is: ebay, p2p or grimys. A BAYC P2P or Grimy’s figure is an estimate (the site prints “~”); eBay’s is the price as listed.

digital_last_sold

The newest sale on chain of that card and finish, in dollars.

physical_last_sold

The newest confirmed sale of a printed copy, in dollars.

Serialized

Not in this file: a serial-numbered copy is its own item and a rule for a crowd fits it badly. Card prices has its asks and sales.