Skip to content
DIGIRAREDevelopers

An address’s public listings

GET
/v1/address/{address}/listings
curl --request GET \
  --url 'https://api.digirare.com/v1/address/example/listings?limit=50'

Public address storefront. Private counteroffers are excluded.

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
address
required

Mainnet P2TR or P2WPKH address. The SIGNING capability: every signature is verified by reconstructing a BIP-143/BIP-341 witness sighash.

string

Query Parameters

Section titled “Query Parameters”
limit
integer
default: 50 >= 1 <= 100
cursor
string

Opaque (created_at,id) continuation token returned as next_cursor.

Responses

Section titled “Responses”

200

Section titled “200”

Seller listing portfolio

Media typeapplication/json
object
result
required
Array
object
id
required
string
asset
required

Canonical compact Counterparty key. A subasset uses its A ID; asset_longname is display metadata.

string
asset_longname
string | null
seller
required

Mainnet P2TR or P2WPKH address. The SIGNING capability: every signature is verified by reconstructing a BIP-143/BIP-341 witness sighash.

string
utxo_txid
required
string
/^[0-9a-f]{64}$/
utxo_vout
required
integer
quantity_raw
required
string
/^(0|[1-9][0-9]*)$/
price_sats
required
integer
>= 1 <= 9007199254740991
created_at
required
integer
protocol_subtype
string | null
media_kind
string | null
Allowed values: image animation video html svg
collection

The asset’s primary listable collection (public storefront read only).

string | null
status
required
string
Allowed values: active pending
expires_at
required
integer | null
private_to
required
One of:

Mainnet P2TR or P2WPKH address. The SIGNING capability: every signature is verified by reconstructing a BIP-143/BIP-341 witness sighash.

string
result_count
required
integer
next_cursor
required
string | null
Example
{
  "result": [
    {
      "media_kind": "image",
      "status": "active"
    }
  ]
}