# List market auctions sample

`GET https://api.unique.domains/v1/market/auctions/sample`

The day's fixed sample of up to 20 single-word names at auction, by deadline.

Drawn once per UTC day from single base-form words on the public TLD set closing that day, at most ten of them with a bid. Never sorted, filtered or paged. No rows while the day has no sample.

- Access: No key. Limited per address; a key adds the paid fields.
- Billing: One call.
- Formats: JSON, CSV (`.csv`)
- 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/auctions/sample"
```

## Response

| Field | Type | Description |
| --- | --- | --- |
| `name` | string |  |
| `ending` | string |  |
| `venue` | string | Auction venue id (`GET /meta/enums` names each). |
| `venueLabel` | string |  |
| `endsAt` | string |  |
| `currency` | string |  |
| `bid` | number \| null |  |
| `bidCount` | integer \| null |  |
| `verdict` | string \| null |  |
| `firstYear` | number \| null |  |
| `tag` | string \| null |  |

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

## Example answer

200, application/json

```json
{
  "data": [
    {
      "name": "harbor.io",
      "ending": "io",
      "venue": "dynadot",
      "venueLabel": "Dynadot",
      "endsAt": "2026-11-05T17:00:00.000Z",
      "currency": "USD",
      "bid": 120,
      "bidCount": 7,
      "verdict": "Good",
      "firstYear": 169.12,
      "tag": "jumped"
    }
  ],
  "meta": {
    "asOf": "2026-11-05T08:00:00Z",
    "cursor": null,
    "limit": null
  },
  "links": {
    "self": "https://api.unique.domains/v1/market/auctions/sample",
    "next": null,
    "register": null,
    "product": null,
    "dataset": null
  }
}
```

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

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