Goldin API endpoint
Goldin's complete auction event history, back to 2012 -- title, type, status, start/end window, and buyer's premium for every auction Goldin has run. Pass an auction's own id as auction_id to goldin-search to browse its lots.
/goldin/auctionsQuery parameters:
order (optional) — asc (oldest first) or desc (newest first,
default).Notable response behavior:
order is the only functional filter. Goldin's own underlying API
requires a status field to be present or it returns no rows at all,
but the field's value has no effect (confirmed live: every status
value returns the identical full history) — this endpoint deliberately
does not expose a status filter, since it would silently do nothing.id as auction_id to goldin-search to browse
that auction's lots.| Field | Filled in, of 496 checked | Values in the sample |
|---|---|---|
| id | 496 | |
| slug | 481 | |
| title | 496 | “2026 Fall Game Used Memorabilia Auction” and 495 other values |
| type | 452 | Weekly (309), Elite (104), Thematic (39) |
| status | 496 | Completed (487), Active (7), Preview (2) |
| start_time | 496 | 2012-10-15 to 2026-10-17 |
| end_time | 496 | 2012-11-18 to 2026-11-08 |
| buyer_premium | 496 | 0 to 25, median 22 |
| extended_bidding_status | 496 | Completed (486), Not_Started (10) |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| order | string | No | asc (oldest first) or desc (newest first, default) Allowed values: asc, desc. | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/goldin/auctions?order=asc" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"total": 485,
"auctions": [
{
"id": "202608-1817-0547-c295cf74-876a-4fb8-af2e-23eb4824a943",
"slug": "2026-fall-coin-and-currency-auction-previewuv8f6",
"title": "2026 Fall Coin and Currency Auction Preview",
"type": "Thematic",
"status": "Preview",
"start_time": "2026-10-03T00:00:00Z",
"end_time": "2026-10-29T02:00:00Z",
"buyer_premium": 22
}
]
}
}Request schema
No body schema
Response schema
#/definitions/goldin.auctionsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | goldin.AuctionsResponse | No | ||||
| data.auctions | array | No | ||||
| data.auctions[].buyer_premium | number | No | ||||
| data.auctions[].end_time | string | No | ||||
| data.auctions[].extended_bidding_status | string | No | ||||
| data.auctions[].id | string | No | ||||
| data.auctions[].slug | string | No | ||||
| data.auctions[].start_time | string | No | ||||
| data.auctions[].status | string | No | ||||
| data.auctions[].title | string | No | ||||
| data.auctions[].type | string | No | ||||
| data.total | integer | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/goldin/auctions?order=asc" \
-H "x-api-key: $CRAWLORA_API_KEY"