Open Resolution Standard

BNRP: Bitcoin Name
Resolution Protocol

An open resolution layer for BTC-native names. BTCNative uses BNRP to read name records, verify ownership, resolve avatars, and display provenance — without claiming to own the names.

API Reference GitHub

What is BNRP?

BNRP is an open resolution layer for BTC-native names. It gives wallets, marketplaces, and apps a shared way to read name records — ownership, avatars, addresses, inscriptions, and provenance data — directly from Bitcoin-native sources.

It is not a registry. It does not issue names. It is the resolver: a standard for reading what already exists on-chain.

BNRP resolves
  • name owner address
  • name primary Bitcoin address
  • name avatar / inscription link
  • name text records (Twitter, website, description)
  • name marketplace listing status
  • address primary name (reverse lookup)
  • namespace supported resolver / indexer

What BTCNative uses it for

BTCNative uses BNRP to index, verify, and display BTC-native identity records across supported namespaces including .btc, .sats, .x, .ord, and others.

Verify ownership
Cross-reference name inscriptions with on-chain owner data before displaying any listing.
Resolve identity cards
Display avatars, display names, descriptions, and linked social handles from on-chain records.
Address resolution
Map Bitcoin names to wallet addresses for display and payment routing.
Provenance signals
Flag first-inscription canonicality and surface re-inscription warnings on buy/sell surfaces.
Reverse lookup
When a wallet connects, resolve the address back to a primary name for display in the nav.
Marketplace status
Show whether a name is currently listed, its price, and last sale data alongside BNRP records.

What BNRP does not mean

BNRP does not custody names. Names are Bitcoin inscriptions. They live on-chain. BNRP only reads them.
BNRP does not own names. Ownership is determined by which address holds the inscription on Bitcoin.
BNRP does not replace Bitcoin. It is a read layer on top of Bitcoin. Bitcoin consensus is the ground truth.
BNRP does not guarantee market value. Resolution and indexing have no bearing on price. Markets determine value.
BNRP is not a partnership claim. Displaying a name from any collection does not imply partnership with that project, marketplace, or wallet unless explicitly stated.

Resolver examples

These are illustrative examples of how BNRP reads name data. Live data is fetched from on-chain sources at resolution time.

satoshi.btc
.btc namespace · BNRP verified
verified
Owner
verified on-chain
Primary address
bc1p… connected
Avatar
inscription-linked
Listing
not listed
pizza.btc
.btc namespace · BNRP verified
verified
Owner
verified on-chain
Primary address
bc1p… connected
Avatar
none set
Listing
listed
puppet.btc
.btc namespace · unresolved
unresolved
Owner
unresolved placeholder
Primary address
unavailable
Avatar
none set
Listing
listed

Developer reference

BNRP provides a normalized record model for BTC-native names. The API returns a consistent shape regardless of which underlying indexer resolved the name.

GET /v1/resolve/{name} Forward resolve — name → records
GET /v1/reverse/{address} Reverse resolve — address → primary name
GET /v1/batch?names=a,b,c Batch resolve — up to 20 names

Base URL: https://api.bnrp.name/v1/

Normalized record model
{
  "name": "example.btc",
  "owner": "bc1p...",
  "primaryAddress": "bc1p...",
  "avatar": "inscriptionId or URL",
  "records": {
    "twitter": "",
    "website": "",
    "description": ""
  },
  "listing": {
    "status": "listed",
    "price": "",
    "marketplace": "BTCNative"
  },
  "provenance": {
    "source": "unisat | btcname | sns",
    "verifiedAt": "2026-01-01T00:00:00Z"
  }
}
Live API Source on GitHub