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

Returns ordered list of listings of a specific collection

GEThttps://api.ordnull.site/v3/collection/listings

Authorization

ApiKeyAuth

Query parameters

Response

200403429

Successful response

Body

application/json

dataarray of ListingData (object)

block_heightinteger

Request

JavaScriptCurlPython

const response = await fetch('https://api.ordnull.site/v3/collection/listings?sort_by=min_price&order=asc&offset=0&count=0&slug=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200403429

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

Get Collections

Returns ordered list of collections with detailed information

GEThttps://api.ordnull.site/v3/collection/collections

Query parameters

Response

200429

Successful response

Body

application/json

dataarray of CollectionData (object)

block_heightinteger

Request

JavaScriptCurlPython

const response = await fetch('https://api.ordnull.site/v3/collection/collections?sort_by=supply&order=asc&offset=0&count=0', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200429

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

Get Collection Information

Returns detailed information about a specific collection

GEThttps://api.ordnull.site/v3/collection/info

Query parameters

Response

200429

Successful response

Body

application/json

dataCollectionInfo (object)

block_heightinteger

Request

JavaScriptCurlPython

const response = await fetch('https://api.ordnull.site/v3/collection/info?slug=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200429

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

Get Collection Sales Information

Returns sales and volume information about a specific collection

GEThttps://api.ordnull.site/v3/collection/sales_info

Authorization

ApiKeyAuth

Query parameters

Response

200403429

Successful response

Body

application/json

dataSalesInfo (object)

block_heightinteger

Request

JavaScriptCurlPython

const response = await fetch('https://api.ordnull.site/v3/collection/sales_info?slug=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200403429

{
  "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": 0,
    "marketplace": "text"
  },
  "block_height": 0
}

Get Collection Listing Changes

Returns recent changes in collection listings across different marketplaces

GEThttps://api.ordnull.site/v3/x/collection/listing_changes

Authorization

ApiKeyAuth

Response

200403429

Successful response

Body

application/json

dataarray of ListingChangeData (object)

block_heightinteger

Current block height

Request

JavaScriptCurlPython

const response = await fetch('https://api.ordnull.site/v3/x/collection/listing_changes', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200403429

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

Get Inscription Activity in Block

Returns the inscription activity on a given block height

GEThttps://api.ordnull.site/v3/inscription/activity_on_block

Authorization

ApiKeyAuth

Query parameters

Response

200403429

Successful response

Body

application/json

dataarray of ActivityData (object)

block_heightinteger

Request

JavaScriptCurlPython

const response = await fetch('https://api.ordnull.site/v3/inscription/activity_on_block?block_height=0', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200403429

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

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.