Skip to main content


Production URL:

OpenAPI Documentation

API Client: @bns-x/client

Apps and wallets that want to integrate with BNS and BNSx can use the BNS API to easily fetch name and address information.

To make the process of integration as easy as possible, the API provides a backwards-compatible interface from the Stacks Blockchain API's BNS endpoints.

When using the BNS API, all requests will prioritize ownership information based on BNSx ownership if the name is on BNSx. This is because names on BNSx have the BNS Core name "wrapped" in a smart contract. This will allow apps to work exactly as expected, whether a name is on BNS or BNSx.

Because migrating to BNSx involves wrapping your BNS Core name, using the Stacks Blockchain API endpoints won't work for users that have upgraded.