raresats.net API
Market data View as Markdown

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 #

ParameterTypeRequiredDescription
seqsstringyes1-500 sequence numbers, comma-separated.

Example request #

cURL
curl 'https://raresats.net/api/sales/parties?seqs=1,2'
JavaScript
const response = await fetch('https://raresats.net/api/sales/parties?seqs=1,2');
const data = await response.json();
Python
import requests

data = requests.get("https://raresats.net/api/sales/parties", params={"seqs": "1,2"}).json()

Response 200 #

FieldTypeDescription
generationintegerSales generation the sequence numbers belong to.
partiesmap of objectKeyed by sequence number. Unknown sequence numbers are absent.
parties.<key>.sellerstring | nullAn address, or null (a script with no address).
parties.<key>.buyerstring | nullAn address, or null (a script with no address).
Response
{
  "generation": 1,
  "parties": {
    "1": {
      "seller": "bc1qcr8te4kr609gcawutmrza0j4xv80jy8z306fyu",
      "buyer": "bc1p5cyxnuxmeuwuvkwfem96lqzszd02n6xdcjrs20cac6yqjjwudpxqkedrcr"
    },
    "2": {
      "seller": "bc1p4qhjn9zdvkux4e44uhx8tc55attvtyu358kutcqkudyccelu0was9fqzwh",
      "buyer": null
    }
  }
}

Errors #

{error} (a message, no code):

StatusWhen
400Missing, too many or malformed sequence numbers.

Sequence numbers belong to a generation of the sales; after a reorg (a new generation) ask again.