Ord Commands

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

Try It Live

Commands Overview

• inscription - Get inscription details by ID
• inscriptions-in-block - Get all inscriptions in a block
• address-info - Get address information
• block-info - Get block information
• block-count - Get the latest block count
• blocks - Get latest blocks
• children - Get children of an inscription
• content - Get inscription content
• output - Get output information
• parents - Get parents of an inscription
• rune - Get rune information
• sat - Get sat information
• tx-info - Get 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": "6fb976ab49dcec017f1e201e84395983204ae1a7c2abf7ced0a85d692e442799i0",
  "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-info

Get detailed block information from the Ord indexer.

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

Arguments:

• <BLOCK_HEIGHT> - Block height 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

Example Output:

850123

ord blocks

Get information about the latest blocks.

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

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 parents

Get parent inscriptions of a child inscription.

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

Arguments:

• <INSCRIPTION_ID> - Child inscription ID

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",
  "timestamp": "2024-04-20T00:00:00Z"
}

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 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:

• 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
}

Next Steps

• Esplora Commands - Block explorer queries
• Alkanes Commands - Protocol operations
• DataAPI Commands - High-level data queries