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.

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.

PreviousInscriptions NextBRC20

Last updated 1 month ago

Get Collection Listings

Returns ordered list of listings of a specific collection

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

Authorization

Query parameters

Response

Successful response

Body

dataarray of object

block_heightinteger

Request

const response = await fetch('https://api.ordnull.site/v3/collection/listings?sort_by=min_price&order=asc&offset=1&count=1&slug=text', {
    method: 'GET',
    headers: {
      "x-api-Key": "ApiKeyAuth <apiKey>"
    },
});
const data = await response.json();

Response

{
  "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

Returns ordered list of collections with detailed information

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

Query parameters

Response

Successful response

Body

dataarray of object

block_heightinteger

Request

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

Response

{
  "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

Returns detailed information about a specific collection

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

Query parameters

Response

Successful response

Body

dataobject

block_heightinteger

Request

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

Response

{
  "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

Returns sales and volume information about a specific collection

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

Authorization

Query parameters

Response

Successful response

Body

dataobject

block_heightinteger

Request

const response = await fetch('https://api.ordnull.site/v3/collection/sales_info?slug=text', {
    method: 'GET',
    headers: {
      "x-api-Key": "ApiKeyAuth <apiKey>"
    },
});
const data = await response.json();

Response

{
  "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

Returns recent changes in collection listings across different marketplaces

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

Authorization

Response

Successful response

Body

dataarray of object

block_heightinteger

Current block height

Request

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

Response

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

Get Inscription Activity in Block

Returns the inscription activity on a given block height

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

Authorization

Query parameters

Response

Successful response

Body

dataarray of object

block_heightinteger

Request

const response = await fetch('https://api.ordnull.site/v3/inscription/activity_on_block?block_height=1', {
    method: 'GET',
    headers: {
      "x-api-Key": "ApiKeyAuth <apiKey>"
    },
});
const data = await response.json();

Response

{
  "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
}