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

ApiKeyAuth

x-api-KeystringRequired

Query parameters

sort_bystring · enumRequiredPossible values:

orderstring · enumRequiredPossible values:

offsetinteger · max: 5000Required

countinteger · min: 20 · max: 200Required

slugstringRequired

Responses

200

Successful response

application/json

403

Invalid API Key

application/json

429

Rate limit exceeded

application/json

get

/collection/listings

HTTPcURLJavaScriptPython

GET /v3/collection/listings?sort_by=min_price&order=asc&offset=1&count=1&slug=text 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

429

Rate limit exceeded

application/json

get

/collection/collections

HTTPcURLJavaScriptPython

GET /v3/collection/collections?sort_by=supply&order=asc&offset=1&count=1 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

429

Rate limit exceeded

application/json

get

/collection/info

HTTPcURLJavaScriptPython

GET /v3/collection/info?slug=text 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

ApiKeyAuth

x-api-KeystringRequired

Query parameters

slugstringRequired

marketplace_typestring · enumOptionalPossible values:

Responses

200

Successful response

application/json

403

Invalid API Key

application/json

429

Rate limit exceeded

application/json

get

/collection/sales_info

HTTPcURLJavaScriptPython

GET /v3/collection/sales_info?slug=text 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

ApiKeyAuth

x-api-KeystringRequired

Responses

200

Successful response

application/json

403

Invalid API Key

application/json

429

Rate limit exceeded

application/json

get

/x/collection/listing_changes

HTTPcURLJavaScriptPython

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

ApiKeyAuth

x-api-KeystringRequired

Query parameters

block_heightintegerRequired

orderstring · enumOptionalPossible values:

sort_bystring · enumOptionalPossible values:

activity_filterintegerOptional

Responses

200

Successful response

application/json

403

Invalid API Key

application/json

429

Rate limit exceeded

application/json

get

/inscription/activity_on_block

HTTPcURLJavaScriptPython

GET /v3/inscription/activity_on_block?block_height=1 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.