Domains

History

This endpoint can be used to retrieve the transaction history for all registered domains. Since the response payload will be large, the below optional query parameters can be passed.

limit - This is the number of records per response up to 200. 200 is also the default if no limit parameter is passed.

start_time - The start in unix timestamp from when the domain transaction records should be obtained.

end_time - The end in unix timestamp to when the domain transaction records should be obtained.

last_token - This token is used to fetch the next set of responses and is recieved from the API response. After the initial API call, you can pass this as a parameter for further responses.

order_by - Sorting direction. Use "ASC" to return results from oldest to newest, or "DESC" (default) to return newest to oldest.

Request

GET v2/domains/history?limit={limit}&start_time={start_time}&end_time={end_time}&last_token={last_token}&order_by={order_by}

Response

{
  "data": [
    {
      "operation": 1,
      "unix_timestamp": 1622592000,
      "tx_signature": "27EjmB4NdsRKMNkeYeF4rva...",
      "domain_key": "4cQ3zUeardJweGTnk...",
      "pre_tx_owner": "5fEPywJMxeP2HBo7JyBUv1G...",
      "post_tx_owner": "CUcYT9ZoBXET88o...",
      "transaction_type": 1,
      "usd_price": 152,
      "price": 1,
      "quote_mint": "So11111111111111111111111111111111111111112"
    }
  ],
  "last_token": "1622592000:abcdef1234567890:domain1"
}

The operation property in the response has the structure below. The transaction_type property correlates to operation where a value of 0 indicates a registration, and a value of 1 indicates a sale or transfer. For other operations, the transaction_type is null.

enum Operation {
  Create, // registration (0)
  Transfer, // sale or transfer (1)
  Update, // update data in a name record (2)
  Delete, // delete or burn a domain (3)
  Realloc, // change the domain storage size (4)
}