# Get market sales

`GET https://api.unique.domains/v1/market/sales`

The domain sales pulse as headline aggregates: windows, price bands and the sold-before count.

Usable sales over 7 days, 30 days and 12 months with their medians (from three sales) and the previous window of the same length, the price-band mix, and the size of the sold-before list. From the nightly sales update; 503 `not_ready` before the first one.

- Access: No key. Limited per address; a key adds the paid fields.
- Billing: One call.
- Formats: JSON
- API: Domain Market API

## Request

| Field | Type | Needs | Where | Description |
| --- | --- | --- | --- | --- |
| `fields` | string | Optional | Query | Comma-separated top-level keys to keep; an unknown key answers 400 `unsupported_field`. |

## Sample request

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

## Response

| Field | Type | Description |
| --- | --- | --- |
| `freshness` | object |  |
| `pulse` | object |  |
| `soldBefore` | object |  |

## Errors

| Code | Status | What it means |
| --- | --- | --- |
| [`rate_limited`](https://unique.domains/api/problems/rate_limited) | 429 | Too many requests |
| [`internal`](https://unique.domains/api/problems/internal) | 500 | Unexpected error |
| [`not_ready`](https://unique.domains/api/problems/not_ready) | 503 | Not ready yet |

## 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
  }
}
```

API status: https://uniquedomains.instatus.com

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