# Domain sales history API

Read the domain sales market as JSON: totals and medians over 7 days, 30 days and 12 months, series by day, week or month, and the sales of one word. Every answer is a figure across many sales; no call lists a single sale.

- Without a key: the market's totals and medians, the series, one word's sales a day, and the summary of the similar sales behind a name.
- With a key: more than one word a day, and whether this exact name sold before.
- Free calls need no key: 60 calls an hour and 100 a day from one address.

## Try it

```bash
curl -X GET "https://api.unique.domains/v1/market/sales"
```

## Example answer

200, application/json

```json
{
  "data": {
    "freshness": {
      "today": "2026-11-05",
      "yesterday": "2026-11-04",
      "rollupAt": "2026-11-05T02:30:00.000Z"
    },
    "pulse": {
      "windows": [
        {
          "id": "7d",
          "count": 2890,
          "prevCount": 2710,
          "medianUsd": 1100,
          "prevMedianUsd": 1050
        }
      ],
      "priceBandMix30d": [
        {
          "band": "50_999",
          "count": 6120
        }
      ],
      "priceBandMix12m": [
        {
          "band": "50_999",
          "count": 71200
        }
      ]
    },
    "soldBefore": {
      "size": 1840
    }
  },
  "meta": {
    "asOf": "2026-11-05T08:00:00Z",
    "cursor": null,
    "limit": null
  },
  "links": {
    "self": "https://api.unique.domains/v1/market/sales",
    "next": null,
    "register": null,
    "product": null,
    "dataset": null
  }
}
```

## Endpoints

- [GET /names/{name}/comps](https://unique.domains/api/get-name-comps) (Free): The similar-sales aggregate of one name and how many endings its word sold on.
- [GET /market/sales](https://unique.domains/api/get-market-sales) (Free): The domain sales pulse as headline aggregates: windows, price bands and the sold-before count.
- [GET /market/sales/series](https://unique.domains/api/list-market-sales-series) (Free): One sales series by day, week or month, oldest first.
- [GET /market/sales/words/{word}](https://unique.domains/api/get-market-sales-word) (Free): One word's sales market over 12 months: count, median, endings sold on and the latest sale's month.

## Ways to call it

- On RapidAPI: Domain Sales History API, https://rapidapi.com/dopamyn-network-dopamyn-network-default/api/domain-sales-history1
- From any language: https://unique.domains/api

## Questions

### Does it list individual sales?

No. Every answer is a figure across many sales (a count, a median, a mean, a price band) or a list of endings, never a sale, a sold name or where it sold.

### Why does a second word answer 429?

Without a key, GET /market/sales/words/{word} reads one word a day per address. The same word again is answered; another word answers 429 until the next UTC midnight.

### What does it answer before the first update?

The totals come from the nightly sales update. Before the first one, GET /market/sales answers 503 with the code not_ready.

Full reference: https://unique.domains/api
