Ord Commands

The ord namespace provides queries for the Ordinals protocol including inscriptions, runes, satoshis, and related data.

Commands Overview

CommandDescription
inscriptionGet inscription details by ID
inscriptions-in-blockGet all inscriptions in a block
address-infoGet address information
block-infoGet block information
block-countGet the latest block count
blocksGet latest blocks
childrenGet children of an inscription
contentGet inscription content
outputGet output information
parentsGet parents of an inscription
runeGet rune information
satGet sat information
tx-infoGet transaction information

ord inscription

Get details about an Ordinal inscription by ID.

alkanes-cli -p mainnet \
  --jsonrpc-url https://mainnet.subfrost.io/v4/jsonrpc \
  ord inscription 6fb976ab49dcec017f1e201e84395983204ae1a7c2abf7ced0a85d692e442799i0

# Arguments:
# <INSCRIPTION_ID>  Inscription ID (format: txid + i + index)

# Example Response:
# {
#   "id": "6fb976ab...i0",
#   "number": 12345,
#   "address": "bc1p...",
#   "content_type": "image/png",
#   "content_length": 1234,
#   "sat": 1234567890,
#   "timestamp": "2024-01-15T12:30:00Z"
# }

ord inscriptions-in-block

Get all inscriptions created in a specific block.

alkanes-cli -p mainnet \
  --jsonrpc-url https://mainnet.subfrost.io/v4/jsonrpc \
  ord inscriptions-in-block 840000

# Arguments:
# <BLOCK_HEIGHT>  Block height to query

ord address-info

Get Ordinals-related information for an address.

alkanes-cli -p mainnet \
  --jsonrpc-url https://mainnet.subfrost.io/v4/jsonrpc \
  ord address-info bc1p...

# Arguments:
# <ADDRESS>  Bitcoin address to query

ord block-count

Get the current block count from the Ord indexer.

alkanes-cli -p mainnet \
  --jsonrpc-url https://mainnet.subfrost.io/v4/jsonrpc \
  ord block-count

# Output:
# 850123

ord rune

Get information about a Rune by name.

alkanes-cli -p mainnet \
  --jsonrpc-url https://mainnet.subfrost.io/v4/jsonrpc \
  ord rune "UNCOMMON•GOODS"

# Arguments:
# <RUNE_NAME>  Rune name (with bullet character if applicable)

# Example Response:
# {
#   "id": "840000:1",
#   "name": "UNCOMMON•GOODS",
#   "symbol": "⧉",
#   "divisibility": 0,
#   "supply": "21000000",
#   "burned": "0"
# }

ord sat

Get information about a specific satoshi.

alkanes-cli -p mainnet \
  --jsonrpc-url https://mainnet.subfrost.io/v4/jsonrpc \
  ord sat 1234567890

# Arguments:
# <SAT>  Satoshi number

# Example Response:
# {
#   "sat": 1234567890,
#   "rarity": "common",
#   "block": 12345,
#   "cycle": 0,
#   "epoch": 0,
#   "period": 0,
#   "inscription": null
# }

ord children

Get child inscriptions of a parent inscription.

alkanes-cli -p mainnet \
  --jsonrpc-url https://mainnet.subfrost.io/v4/jsonrpc \
  ord children 6fb976ab49dcec017f1e201e84395983204ae1a7c2abf7ced0a85d692e442799i0

# Arguments:
# <INSCRIPTION_ID>  Parent inscription ID

ord content

Get the content of an inscription.

alkanes-cli -p mainnet \
  --jsonrpc-url https://mainnet.subfrost.io/v4/jsonrpc \
  ord content 6fb976ab49dcec017f1e201e84395983204ae1a7c2abf7ced0a85d692e442799i0

# Arguments:
# <INSCRIPTION_ID>  Inscription ID

# Returns the raw content bytes of the inscription.

ord output

Get information about a specific transaction output.

alkanes-cli -p mainnet \
  --jsonrpc-url https://mainnet.subfrost.io/v4/jsonrpc \
  ord output <TXID>:<VOUT>

# Arguments:
# <OUTPOINT>  Transaction output (format: txid:vout)

ord tx-info

Get transaction information from the Ord indexer.

alkanes-cli -p mainnet \
  --jsonrpc-url https://mainnet.subfrost.io/v4/jsonrpc \
  ord tx-info <TXID>

# Arguments:
# <TXID>  Transaction ID

JSON-RPC Equivalent

These CLI commands correspond to JSON-RPC methods:

# CLI → JSON-RPC mapping:
# ord inscription → ord_inscription
# ord rune → ord_rune
# ord sat → ord_sat
# ord block-count → ord_blockcount

# Example JSON-RPC:
{
  "jsonrpc": "2.0",
  "method": "ord_inscription",
  "params": ["6fb976ab49dcec017f1e201e84395983204ae1a7c2abf7ced0a85d692e442799i0"],
  "id": 1
}