# Get market auctions

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

Today's domain auctions by venue, ending and length, the next seven days and the tracked counts.

The scanner's daily auction statistics in a neutral order (venues in catalog order, endings of the public set in seed order, lengths ascending) and the counts of the names we track. Figures are null and lists empty before the first read of the day.

- 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/auctions"
```

## Response

| Field | Type | Description |
| --- | --- | --- |
| `day` | string \| null |  |
| `closing` | integer \| null |  |
| `withBid` | integer \| null |  |
| `counts` | object |  |
| `byVenue` | object[] |  |
| `byEnding` | object[] |  |
| `byLength` | object[] |  |
| `next7Days` | 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 |

## Example answer

200, application/json

```json
{
  "data": {
    "day": "2026-11-05",
    "closing": 18420,
    "withBid": 2210,
    "counts": {
      "today": 38,
      "results": 51,
      "all": 1204
    },
    "byVenue": [
      {
        "venue": "godaddy",
        "closing": 12100,
        "withBid": 1580,
        "medianBidUsd": 25
      }
    ],
    "byEnding": [
      {
        "ending": "com",
        "closing": 11200,
        "withBid": 1490,
        "medianBidUsd": 30
      }
    ],
    "byLength": [
      {
        "length": 5,
        "closing": 1300,
        "withBid": 240,
        "medianBidUsd": 45
      }
    ],
    "next7Days": [
      {
        "day": "2026-11-05",
        "closing": 18420
      }
    ]
  },
  "meta": {
    "asOf": "2026-11-05T08:00:00Z",
    "cursor": null,
    "limit": null
  },
  "links": {
    "self": "https://api.unique.domains/v1/market/auctions",
    "next": null,
    "register": null,
    "product": null,
    "dataset": null
  }
}
```

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

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