Username API

Open-source, non-custodial name service for the Nano blockchain.

Names

Names are unique, ephemeral and standardized for API use.

Dataset: https://nano.to/known.json

Aliases

Aliases are used on nanobrowse.com and nanolooker.com. Aliases don't expire and can contain spaces, but are not standardized for API use.

Dataset: https://nano.to/aliases.json

Register

• Usernames: Nano.to
• Aliases: Nanobrowse.com

Via RPC

curl -d '{
  "action": "get_name",
  "name": "NanoBull"
}' \
-H "Content-Type: application/json" \
"https://rpc.nano.to"

Basic Usage

Name:

https://nano.to/Fosse

Raw Address:

https://nano.to/:ADDRESS

Single Panel

https://nano.to/Fosse?amount=50

Double Panel

https://nano.to/Moon?plans=Tip:0.133,Small:1,Medium:10,Large:20,Gigantic:100

Customize Colors

https://nano.to/Moon
?background=$0057b7:$ffd700
&color=$FFF:$000
&highlight=white
&vanity=$0057b7
&qrcode=white:$0057b7
&logo=https://nano.to/dist/logo/cyber.png

Available Options

• title (string) : Replace checkout title.
• amount (number) : Single panel, No plans.
• body (string) : Custom checkout text body.
• plans (string) : Plans separated by commas. Ex. Tip:30,Small:5
• goal (string) : Show a funding meter based off balance.
• image (image/url) : Display Image. Image URL.
• color (string) : Text color. Ex red:blue
• background (string) : Background color. Ex white:gray
• highlight (string) : Box backgrounds value. Ex blue:red
• qrcode (string) : Replace QR Code color. Ex white:black
• active (string) : Background color of active plan.
• logo (image/url) : Replace QR Code logo. Image URL.
• cancel (string) : Redirect URL when pressed 'Cancel'
• redirect (string) : Redirect URL on success.
• currency, c (string) : ISO Currency Symbol. Ex JPY
• notify, (string) : Email(s) or Discord Webhook URL

Funding UI

Easily show a meter of progress for any Nano fundraiser.

https://nano.to/@Basedlemahieu?goal=100:Funding Goal

Update Name

You can update your data anytime.

https://nano.to/:USERNAME/update

Only original address may update. You can pre-configure URL params in the metadata field of update UI.

Renew Name

You can extend registration anytime.

https://nano.to/:USERNAME/renew

Only original address may add time.

Grace Periods

Usernames have 10 day after expiration, regardless of duration leased. Only the original address may renew.

Checkout API

If you'd like receive notifications and private webhooks, try the Checkout API

Usage License

Nano.to Names are licensed under Limited Commercial Use:

• ✅ Personal & Open Source
• ✅ Commercial use where Nano.to Usernames / Checkout is a means.
• ❌ Commercial use where Nano.to Usernames / Checkout is re-sold.

Contact [email protected] for questions.

Nano.to Support

• Email: [email protected]
• Twitter: @nano2dev
• @nano2dev on Nano's Discord