Sale parties
GET/api/sales/parties
The seller's and buyer's addresses of up to 500 sales by sequence number (null: a script with no address). Cacheable 30 s.
Query parameters #
| Parameter | Type | Required | Description |
|---|---|---|---|
seqs | string | yes | 1-500 sequence numbers, comma-separated. |
Example request #
curl 'https://raresats.net/api/sales/parties?seqs=1,2'const response = await fetch('https://raresats.net/api/sales/parties?seqs=1,2');
const data = await response.json();import requests
data = requests.get("https://raresats.net/api/sales/parties", params={"seqs": "1,2"}).json()Response 200 #
| Field | Type | Description |
|---|---|---|
generation | integer | Sales generation the sequence numbers belong to. |
parties | map of object | Keyed by sequence number. Unknown sequence numbers are absent. |
parties.<key>.seller | string | null | An address, or null (a script with no address). |
parties.<key>.buyer | string | null | An address, or null (a script with no address). |
{
"generation": 1,
"parties": {
"1": {
"seller": "bc1qcr8te4kr609gcawutmrza0j4xv80jy8z306fyu",
"buyer": "bc1p5cyxnuxmeuwuvkwfem96lqzszd02n6xdcjrs20cac6yqjjwudpxqkedrcr"
},
"2": {
"seller": "bc1p4qhjn9zdvkux4e44uhx8tc55attvtyu358kutcqkudyccelu0was9fqzwh",
"buyer": null
}
}
}Errors #
{error} (a message, no code):
| Status | When |
|---|---|
| 400 | Missing, too many or malformed sequence numbers. |
Sequence numbers belong to a generation of the sales; after a reorg (a new generation) ask again.