# List market auction outcomes

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

Confirmed auction outcomes by venue, day and currency, as counts and medians.

Each group's count of confirmed outcomes and their median amount in its currency, null under three outcomes. Newest day first, keyset on `(day, venue, currency)`.

- Access: A member key (Founder or Investor) or a paid RapidAPI subscription to this API.
- Billing: One call.
- Plan: Investor plan. A Founder key answers 403 `plan_required`.
- Formats: JSON, CSV (`.csv`)
- API: Domain Market API

## Request

| Field | Type | Needs | Where | Description |
| --- | --- | --- | --- | --- |
| `venue` | string: godaddy, dynadot, namesilo, namecheap, snapnames, parkio, domainlore | Optional | Query | One venue only. |
| `limit` | integer | Optional | Query | Rows a page: 20 by default, at most 20 without a key and 100 with a paid subscription; a larger value is clamped. |
| `cursor` | string | Optional | Query | The `meta.cursor` of the previous page; the last page answers `null`. |
| `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/outcomes" \
  -H "Authorization: Bearer YOUR_MEMBER_KEY"
```

## Response

| Field | Type | Description |
| --- | --- | --- |
| `venue` | string | Auction venue id (`GET /meta/enums` names each). |
| `venueLabel` | string |  |
| `day` | string |  |
| `currency` | string |  |
| `count` | integer |  |
| `median` | number \| 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": [
    {
      "venue": "dynadot",
      "venueLabel": "Dynadot",
      "day": "2026-11-04",
      "currency": "USD",
      "count": 42,
      "median": 180
    }
  ],
  "meta": {
    "asOf": null,
    "cursor": null,
    "limit": 20
  },
  "links": {
    "self": "https://api.unique.domains/v1/market/auctions/outcomes",
    "next": null,
    "register": null,
    "product": null,
    "dataset": null
  }
}
```

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

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