# Get word market

`GET https://api.unique.domains/v1/words/{word}/market`

A word's sales and auction aggregates from the nightly update.

Usable sales of the word itself over 12 months and 30 days, the median from three sales, the count of endings it sold on and its open auctions per ending. Aggregates only.

- Access: No key. Limited per address; a key adds the paid fields.
- Billing: One call.
- Plan: Investor plan for the paid fields. A Founder key reads the free shape.
- Formats: JSON
- API: Word Intelligence API

## Request

| Field | Type | Needs | Where | Description |
| --- | --- | --- | --- | --- |
| `word` | string | Required | Path | The catalog slug, the word, or `wrd_<id>`. |
| `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/words/harbor/market"
```

## Response

| Field | Type | Description |
| --- | --- | --- |
| `sales12m` | integer |  |
| `sales30d` | integer |  |
| `medianFromThree` | integer \| null | USD, only from 3 sales. |
| `endingsSoldOn` | integer |  |
| `openAuctionsByEnding` | object | `{ ending: count }`. |

## Errors

| Code | Status | What it means |
| --- | --- | --- |
| [`not_found`](https://unique.domains/api/problems/not_found) | 404 | Not found |
| [`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": {
    "sales12m": 4,
    "sales30d": 1,
    "medianFromThree": 2150,
    "endingsSoldOn": 3,
    "openAuctionsByEnding": {
      "com": 1,
      "io": 1
    }
  },
  "meta": {
    "asOf": "2026-11-05T08:00:00Z",
    "cursor": null,
    "limit": null
  },
  "links": {
    "self": "https://api.unique.domains/v1/words/harbor/market",
    "next": null,
    "register": null,
    "product": null,
    "dataset": null
  }
}
```

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

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