Collections

Collections API

Our Collections API endpoints provide detailed access to BTC Ordinals and Runes collection data. Effortlessly retrieve:

  • Collection Summaries: Key statistics and overviews.

  • Individual Collection Details: Granular insights into specific collections.

  • Historical and Real-Time Data: Power your tools with the most accurate information available.

Get Collection Listings

get

Returns ordered list of listings of a specific collection

Authorizations
Query parameters
sort_bystring · enumRequiredPossible values:
orderstring · enumRequiredPossible values:
offsetinteger · max: 5000Required
countinteger · min: 20 · max: 200Required
slugstringRequired
Responses
200
Successful response
application/json
get
GET /v3/collection/listings HTTP/1.1
Host: api.ordnull.site
x-api-Key: YOUR_API_KEY
Accept: */*

{
  "data": [
    {
      "inscription_id": "text",
      "min_price": 1,
      "ordswap_price": 1,
      "magiceden_price": 1,
      "ordinalswallet_price": 1,
      "gammaio_price": 1,
      "nostr_price": 1,
      "odynals_price": 1,
      "unisat_price": 1,
      "ordinalsmarket_price": 1,
      "okx_price": 1,
      "owner_wallet_addr": "text"
    }
  ],
  "block_height": 1
}

Get Collections

get

Returns ordered list of collections with detailed information

Query parameters
sort_bystring · enumRequiredPossible values:
orderstring · enumRequiredPossible values:
offsetintegerRequired
countinteger · min: 20 · max: 200Required
Responses
200
Successful response
application/json
get
GET /v3/collection/collections HTTP/1.1
Host: api.ordnull.site
Accept: */*

{
  "data": [
    {
      "name": "text",
      "slug": "text",
      "inscription_icon_id": "text",
      "icon_url": "text",
      "icon_render_url": "text",
      "bis_url": "text",
      "supply": "text",
      "min_number": 1,
      "median_number": 1,
      "max_number": 1,
      "listed_count": 1,
      "floor_price": 1,
      "floor_price_ordswap": 1,
      "floor_price_magiceden": 1,
      "floor_price_ordinalswallet": 1,
      "floor_price_gammaio": 1,
      "floor_price_ordynals": 1,
      "floor_price_ordinalsmarket": 1,
      "floor_price_unisat": 1,
      "floor_price_okx": 1,
      "vol_24h_in_btc": 1,
      "vol_7d_in_btc": 1,
      "sale_cnt_7d": 1,
      "vol_total_in_btc": 1,
      "sale_cnt_total": 1,
      "marketcap": 1
    }
  ],
  "block_height": 1
}

Get Collection Information

get

Returns detailed information about a specific collection

Query parameters
slugstringRequired
Responses
200
Successful response
application/json
get
GET /v3/collection/info HTTP/1.1
Host: api.ordnull.site
Accept: */*

{
  "data": {
    "name": "text",
    "twitter_link": "text",
    "discord_link": "text",
    "website_link": "text",
    "description": "text",
    "supply": "text",
    "inscription_icon_id": "text",
    "min_number": 1,
    "median_number": 1,
    "max_number": 1,
    "icon_url": "text",
    "icon_render_url": "text",
    "bis_url": "text"
  },
  "block_height": 1
}

Get Collection Sales Information

get

Returns sales and volume information about a specific collection

Authorizations
Query parameters
slugstringRequired
marketplace_typestring · enumOptionalPossible values:
Responses
200
Successful response
application/json
get
GET /v3/collection/sales_info HTTP/1.1
Host: api.ordnull.site
x-api-Key: YOUR_API_KEY
Accept: */*

{
  "data": {
    "vol_3h": "text",
    "vol_6h": "text",
    "vol_9h": "text",
    "vol_12h": "text",
    "vol_1d": "text",
    "vol_3d": "text",
    "vol_7d": "text",
    "vol_30d": "text",
    "vol_total": "text",
    "sale_count": 1,
    "marketplace": "text"
  },
  "block_height": 1
}

Get Collection Listing Changes

get

Returns recent changes in collection listings across different marketplaces

Authorizations
Responses
200
Successful response
application/json
get
GET /v3/x/collection/listing_changes HTTP/1.1
Host: api.ordnull.site
x-api-Key: YOUR_API_KEY
Accept: */*

{
  "data": [
    {
      "marketplace": "magiceden",
      "slug": "text",
      "inscription_id": "text",
      "price": 1,
      "is_listed": true,
      "change_ts": 1
    }
  ],
  "block_height": 1
}

Get Inscription Activity in Block

get

Returns the inscription activity on a given block height

Authorizations
Query parameters
block_heightintegerRequired
orderstring · enumOptionalPossible values:
sort_bystring · enumOptionalPossible values:
activity_filterintegerOptional
Responses
200
Successful response
application/json
get
GET /v3/inscription/activity_on_block HTTP/1.1
Host: api.ordnull.site
x-api-Key: YOUR_API_KEY
Accept: */*

{
  "data": [
    {
      "inscription_id": "text",
      "from_wallet": "text",
      "to_wallet": "text",
      "block_height": 1,
      "sale_price": 1,
      "new_satpoint": "text",
      "ts": "text",
      "marketplace_type": "text",
      "inscription_name": "text",
      "inscription_number": 1,
      "collection_name": "text",
      "collection_slug": "text",
      "tx_id": "text",
      "is_me_cpfp_bundle": true,
      "me_cpfp_bundle_hash": "text",
      "me_cpfp_final_destination_wallet": "text"
    }
  ],
  "block_height": 1
}

Want Access? Request Your API Key!

Like what you see? Take the next step! 👉 Fill out the form on our website to request your API key and unlock access to all our Collections endpoints.

PreviousInscriptionsNextBRC20

Last updated