Nano Currency API for developers, exchanges, and everyone in between. Understand the core details of the nano protocol and more. Start building with Nano today.

Introduction

Nano.to API is organized around REST.

The API has predictable resource-oriented URLs, accepts form-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

Not a developer?

We offer no-code and low-code options to get started.

Public RPC
https://rpc.nano.to
CLIENT LIBRARIES
Axios
$ npm install axios
Authentication

Nano.to uses API keys to authenticate requests. You can view and manage your API keys in the Dashboard.

Your API keys carry many privileges, so be sure to keep them secure! Do not share your secret API keys in publicly accessible areas such as GitHub, client-side code, and so forth.

API requests must be made over HTTPS. Calls over HTTP will fail.

Public RPC
Bring Nano currency to the people. Free node access for developers, exchanges, and everyone in between.
Base URL
https://rpc.nano.to
CLIENT LIBRARIES
Axios
$ npm install axios
accounts_balances
Returns the balances of multiple accounts specified in the request.
Attributes
accounts array

Array containing Public Nano address or Nano.to @Username

Axios
const axios = require('axios');

axios.post('https://rpc.nano.to', {
  "action": "accounts_balances",
  "accounts": [
    "@development",
    "nano_3i1aq1cchnmbn9x5rsbap8b15akfh7wj7pwskuzi7ahz8oq6cobd99d4r3b7",
    "@faucet"
  ]
}).then((res) => {
  console.log(res.data);
});
Response
{
  "balances": {
    "@development": {
      "balance": "325586539664609129644855132177",
      "balance_nano": "0.32558653966460912964",
      "pending": "2309372510769300000000000000000000",
      "pending_nano": "2309.3725107693",
      "receivable": "2309372510769300000000000000000000",
      "receivable_nano": "2309.3725107693"
    },
    "nano_3i1aq1cchnmbn9x5rsbap8b15akfh7wj7pwskuzi7ahz8oq6cobd99d4r3b7": {
      "balance": "0",
      "balance_nano": "0",
      "pending": "0",
      "pending_nano": "0",
      "receivable": "0",
      "receivable_nano": "0"
    },
    "@faucet": {
      "balance": "2815988528585400000000000000000",
      "balance_nano": "2.8159885285854",
      "pending": "0",
      "pending_nano": "0",
      "receivable": "0",
      "receivable_nano": "0",
      "address": "nano_1faucet7b6xjyha7m13objpn5ubkquzd6ska8kwopzf1ecbfmn35d1zey3ys"
    }
  }
}
accounts_receivable
Returns the pending receivable blocks for multiple accounts specified in the request.
Attributes
accounts array

Array containing Public Nano address or Nano.to @Username

count number

Limit amount of blocks. Max 1000. Contact us for higher limits.

Axios
const axios = require('axios');

axios.post('https://rpc.nano.to', {
  "action": "accounts_receivable",
  "accounts": [
    "nano_1111111111111111111111111111111111111111111111111117353trpda",
    "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3"
  ],
  "count": "1"
}).then((res) => {
  console.log(res.data);
});
Response
{
  "blocks": {
    "nano_1111111111111111111111111111111111111111111111111117353trpda": [
      "142A538F36833D1CC78B94E11C766F75818F8B940771335C6C1B8AB880C5BB1D"
    ],
    "nano_3t6k35gi95xu6tergt6p69ck76ogmitsa8mnijtpxm9fkcm736xtoncuohr3": [
      "4C1FEEF0BEA7F50BE35489A1233FE002B212DEA554B55B1B470D78BD8F210C74"
    ]
  }
}
account_balance
Returns the current balance for the specified account.
Attributes
account string

Public Nano address or Nano.to @Username

Axios
const axios = require('axios');

axios.post('https://rpc.nano.to', {
  "action": "account_balance",
  "account": "@development"
}).then((res) => {
  console.log(res.data);
});
Response
{
  "balance": "325586539664609129644855132177",
  "pending": "2309372510769300000000000000000000",
  "receivable": "2309372510769300000000000000000000",
  "balance_nano": "0.32558653966460912964",
  "pending_nano": "2309.3725107693",
  "receivable_nano": "2309.3725107693"
}
account_history
Returns a list of transactions history for the specified account, including send/receive blocks and amounts.
Attributes
account string

Public Nano address or Nano.to @Username

count number

Limit amount of blocks. Max 1000. Contact us for higher limits.

Axios
const axios = require('axios');

axios.post('https://rpc.nano.to', {
  "action": "account_history",
  "account": "@faucet",
  "count": "1"
}).then((res) => {
  console.log(res.data);
});
Response
{
  "account": "nano_1faucet7b6xjyha7m13objpn5ubkquzd6ska8kwopzf1ecbfmn35d1zey3ys",
  "history": [
    {
      "type": "send",
      "account": "nano_1bank1q3...aosg8kyr51qsdkm8g45",
      "amount": "10000000000000000000000",
      "amount_nano": "0.00000001",
      "local_timestamp": "1679167126",
      "height": "40648",
      "hash": "54DD08EE75157BC03E3B94FBDCBEBF9E3112704F15E21FBD014234FA7ADC131E",
      "confirmed": "true",
      "username": "bank"
    }
  ],
  "previous": "036FF72D6204CAC1024777FE535F4DB5BB4052DF130DC2E431FD360086D71F49"
}
account_info
Returns account information including account balance, block count, and representative for the specified account.
Attributes
account string

Public Nano address or Nano.to @Username

Axios
const axios = require('axios');

axios.post('https://rpc.nano.to', {
  "action": "account_info",
  "account": "@development"
}).then((res) => {
  console.log(res.data);
});
Response
{
  "frontier": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C",
  "open_block": "991CF190094C00F0B68E2E5F75F6BEE95A2E0BD93CEAA4A6734DB9F19B728948",
  "representative_block": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C",
  "balance": "325586539664609129644855132177",
  "balance_nano": "0.32558653966460912964",
  "modified_timestamp": "1598514077",
  "block_count": "44",
  "account_version": "2",
  "confirmation_height": "44",
  "confirmation_height_frontier": "023B94B7D27B311666C8636954FE17F1FD2EAA97A8BAC27DE5084FBBD5C6B02C"
}
account_key
Returns the public key for the specified account.
Attributes
account string

Public Nano address or Nano.to @Username

Axios
const axios = require('axios');

axios.post('https://rpc.nano.to', {
  "action": "account_key",
  "account": "@faucet"
}).then((res) => {
  console.log(res.data);
});
Response
{
  "key": "3068BB1CA04525BB0E4...8B6E8DA958A7FA039"
}
blocks_info
Returns information about multiple blocks specified in the request.
Attributes
source boolean

Return the sending address in response

receive_hash boolean

Return the sending hash in response

hashes array

Array of multiple Nano block hashes

Axios
const axios = require('axios');

axios.post('https://rpc.nano.to', {
  "action": "blocks_info",
  "source": "true",
  "receive_hash": "true",
  "hashes": [
    "E2FB233EF4554077A7BF1AA85851D5BF0B36965D2B0FB504B2BC778AB89917D3",
    "67D9F9F03566D22926159193BD5BDE549FBE8308807C666BCCD3CEA098FBF49D"
  ]
}).then((res) => {
  console.log(res.data);
});
Response
{
  "blocks": {
    "67D9F9F03566D22926159193BD5BDE549FBE8308807C666BCCD3CEA098FBF49D": {
      "amount": "1240000000000000000000000000",
      "balance": "11017588042701000000000000000000",
      "block_account": "nano_1pnano6m6o1ix3eshr6fj9rryd4ckziyii1mf3ychqno9t3soz638dc9fj9a",
      "confirmed": "true",
      "contents": {
        "account": "nano_1pnano6m6o1ix3eshr6fj9rryd4ckziyii1mf3ychqno9t3soz638dc9fj9a",
        "balance": "11017588042701000000000000000000",
        "link": "3E9955573B6A932AF30DA52C33E8152E78D203ADA8B8BC1DC99E785019A34E9D",
        "link_as_account": "nano_1hnscodmptnm7dsiubbe8hn3cdmrta3tuc7rqigwm9mrc1et8mnxibtso67a",
        "previous": "7FD83954BC187AF1473BAD33F07D4EE634733BFEDBE3D56CC10997F417F3C625",
        "representative": "nano_3pnanopr3d5g7o45zh3nmdkqpaqxhhp3mw14nzr41smjz8xsrfyhtf9xac77",
        "signature": "3D2438195A0E91A1F26C959C47F9014A84C11ED150241B4B017411FA6C79096D74FD7E731D708AFAAEEB7F95534DA7D5D42BB6343D7C3F51CA0BE5520058980F",
        "type": "state",
        "work": "14c98d6e8f7f4ad8",
        "balance_nano": "11.017588042701"
      },
      "height": "271199",
      "local_timestamp": "1674588370",
      "receive_hash": "4DCA5A5E2C732A6899292B9091B7A90CE87E8063954498DF30F469416E6DD6C0",
      "source_account": "0",
      "subtype": "send",
      "successor": "FD83C514FA18E59EF1A3D7C3D3760AEF942C077BD0660A5C4C10F617FFB3D580",
      "balance_nano": "11.017588042701",
      "amount_nano": "0.00124"
    },
    "E2FB233EF4554077A7BF1AA85851D5BF0B36965D2B0FB504B2BC778AB89917D3": {
      "amount": "30000000000000000000000000000000000",
      "balance": "40200000001000000000000000000000000",
      "block_account": "nano_1qato4k7z3spc8gq1zyd8xeqfbzsoxwo36a45ozbrxcatut7up8ohyardu1z",
      "confirmed": "true",
      "contents": {
        "account": "nano_1qato4k7z3spc8gq1zyd8xeqfbzsoxwo36a45ozbrxcatut7up8ohyardu1z",
        "balance": "40200000001000000000000000000000000",
        "link": "87434F8041869A01C8F6F263B87972D7BA443A72E0A97D7A3FD0CCC2358FD6F9",
        "link_as_account": "nano_33t5by1653nt196hfwm5q3wq7oxtaix97r7bhox5zn8eratrzoqsny49ftsd",
        "previous": "6CDDA48608C7843A0AC1122BDD46D9E20E21190986B19EAC23E7F33F2E6A6766",
        "representative": "nano_3pczxuorp48td8645bs3m6c3xotxd3idskrenmi65rbrga5zmkemzhwkaznh",
        "signature": "A5DB164F6B81648F914E49CAB533900C389FAAD64FBB24F6902F9261312B29F730D07E9BCCD21D918301419B4E05B181637CF8419ED4DCBF8EF2539EB2467F07",
        "type": "state",
        "work": "000bc55b014e807d",
        "balance_nano": "40200.000001"
      },
      "height": "74",
      "local_timestamp": "0",
      "receive_hash": "0000000000000000000000000000000000000000000000000000000000000000",
      "source_account": "nano_1ipx847tk8o46pwxt5qjdbncjqcbwcc1rrmqnkztrfjy5k7z4imsrata9est",
      "subtype": "receive",
      "successor": "678B9357455396B228325CA5A5CA7237DCC42362693DCAEFA840DEE171596349",
      "balance_nano": "40200.000001",
      "amount_nano": "30000"
    }
  }
}
block_count
Returns the number of blocks in the ledger.
Axios
const axios = require('axios');

axios.post('https://rpc.nano.to', {
  "action": "block_count"
}).then((res) => {
  console.log(res.data);
});
Response
{
  "block_count": "175659188",
  "cemented_count": "175659165",
  "unchecked_count": "23"
}
block_info
Returns information about a specific block identified by its block hash.
Attributes
hash string

Nano block hash

Axios
const axios = require('axios');

axios.post('https://rpc.nano.to', {
  "action": "block_info",
  "hash": "B5E0BE6DAB75740A...06CC4EC7A548F4AFD37A"
}).then((res) => {
  console.log(res.data);
});
Response
{
  "block_account": "nano_36zroxcwrc3okientagy18ccr51fz9qbj3y9guwzroh46uu3oyford19n5sp",
  "amount": "110000000000000000000000000000",
  "amount_nano": "0.11",
  "balance": "1798087000000000000000000000000",
  "balance_nano": "1.798087",
  "height": "347",
  "local_timestamp": "1679170643",
  "successor": "0000000000000000000000000000000000000000000000000000000000000000",
  "confirmed": "true",
  "contents": {
    "type": "state",
    "account": "nano_36zroxcwrc3okientagy18ccr51fz9qbj3y9guwzroh46uu3oyford19n5sp",
    "previous": "F87183445CCBDA814D4FEA653D58DAA5E0BE35ACE33FF04ED1EC7B79430A1DF9",
    "representative": "nano_3pnanopr3d5g7o45zh3nmdkqpaqxhhp3mw14nzr41smjz8xsrfyhtf9xac77",
    "balance": "1798087000000000000000000000000",
    "balance_nano": "1.798087",
    "link": "3A9938F2E17DE4DA81D4E4FA413B1291BBCAC7839775BC76562731386B547883",
    "link_as_account": "nano_1gns95sg4zh6uc1xbs9ta6xj76fusd5r97uoqju7ebsj93ooay656kwa6i8p",
    "signature": "04320501F47B4FD291B5EC7438F31BEAF59B22A447E33021296F3113C38FC26375C4DB14C26901159A900DAB18E91CA5152C6FE8DB5F19B70A3E4FE54048FD09",
    "work": "1ed0bc478d446610"
  },
  "subtype": "send"
}
checkout
Create non-custodial payments sessions for the Nano blockchain.
Attributes
title string

The Nano address which the user will pay and funds will be send to.

notify string

Valid email address(s) to receive payment notification.

webhook string

Private HTTP(S) URL to receive payment notification via POST body.

address string

The Nano address which the user will pay and funds will be send to.

line_items array

Array of products including: title, price and quantity.

success_url array

Used for Nano.to Checkout UI, users are redirect to this url after payment.

amount number

The Nano amount for Checkout session.

shipping number

Add a shipping cost to the checkout.

metadata object

Set of key-value pairs that you can attach to an object. Useful for attaching custom information to the Checkout session.

Axios
const axios = require('axios');

axios.post('https://rpc.nano.to', {
  "action": "checkout",
  "title": "T-Shirt Store",
  "webhook": "https://example/webhook/secret",
  "address": "YOUR_ADDRESS",
  "line_items": [
    {
      "title": "Nike T-Shirt",
      "price": 40,
      "quantity": 1,
      "variant": 28474
    }
  ],
  "metadata": {
    "secret": "joe-doe"
  }
}).then((res) => {
  console.log(res.data);
});
Response
{
  "id": "CHECKOUT_ID",
  "browser": "https://nano.to/CHECKOUT_ID",
  "json": "https://api.nano.to/checkout/CHECKOUT_ID",
  "check": "https://api.nano.to/confirm/CHECKOUT_ID",
  "address": "YOUR_ADDRESS",
  "amount": "0.133",
  "amount_raw": "133000000000000000000000000000",
  "link": "nano:YOUR_ADDRESS?amount=133000047580000000000000000000",
  "qrcode": "data:image/png;base64.."
}
Webhook POST (Private)
{
  "block": {
    "hash": "786DD3F82BFEAF80A668EB87498531DE114F1A9BB7AF30558B4136AB69F5133E",
    "account": "PAYER_ADDRESS",
    "amount": 50,
    "amount_raw": "500000000000000000000000000000"
  },
  "line_items": [
    {
      "title": "Nike T-Shirt",
      "price": 40,
      "quantity": 1,
      "variant": 28474
    }
  ],
  "email": "[email protected]",
  "shipping": {
    "city": "Miami",
    "country": "US",
    "street_address": "123 Fake Ave",
    "street_address_two": "Apt. 4",
    "postal_code": "90210",
    "state": "FL"
  },
  "shipping_amount": 10,
  "metadata": {
    "secret": "joe-doe"
  },
  "success_url": "https://example.com/success/{CHECKOUT_SESSION_ID}",
  "webhook": {
    "response": "FROM_YOUR_SERVER"
  },
  "checkout": "https://api.nano.to/checkout/CHECKOUT_ID"
}
find_block
Finds and returns the block hash for a specific transaction identifier.
Attributes
account string

Public Nano address or Nano.to @Username

amount boolean

Payment amount of block

Axios
const axios = require('axios');

axios.post('https://rpc.nano.to', {
  "action": "find_block",
  "account": "@bank",
  "amount": "0.00755"
}).then((res) => {
  console.log(res.data);
});
Response
{
  "block": {
    "type": "receive",
    "account": "nano_1rpc19tpfzuotsk346bt674mehj96ju86n5xiop4o68mepqexf5f55xa7ycx",
    "amount": "0.00755",
    "local_timestamp": "1712536738",
    "height": "5873",
    "hash": "B64C23DD46A05B9774F4812E86463815784CFA37E834ED5F2F77B13A9C6D6254",
    "confirmed": "true",
    "amount_nano": "0.00755",
    "username": "Rpc",
    "amount_raw": "7550000000000000000000000000"
  }
}
get_name
Register Nano.to Username via API. Paid with Nano.
Attributes
name string

Valid username to register.

Axios
const axios = require('axios');

axios.post('https://rpc.nano.to', {
  "action": "get_name",
  "name": "NanoBull"
}).then((res) => {
  console.log(res.data);
});
Response
{
  "id": "CHECKOUT_ID",
  "address": "nano_1name....",
  "browser": "http://nano.to/pay_CHECKOUT_ID",
  "check": "https://rpc.nano.to/check/CHECKOUT_ID",
  "available": true,
  "plans": [
    {
      "value": "0.0106987",
      "title": "2 Days",
      "value_raw": "10698700000000000000000000000"
    },
    {
      "value": "0.0508923",
      "title": "1 Month",
      "discount": 50,
      "value_raw": "50892300000000000000000000000"
    },
    {
      "value": "0.309268",
      "title": "1 Year",
      "discount": 50,
      "value_raw": "309268000000000000000000000000"
    },
    {
      "value": "0.505576",
      "title": "2 Years",
      "discount": 50,
      "value_raw": "505576000000000000000000000000"
    },
    {
      "value": "10.04408",
      "title": "10 Years",
      "value_raw": "10044080000000000000000000000000"
    }
  ]
}
market_data
Returns market data information related to Nano cryptocurrency.
Axios
const axios = require('axios');

axios.post('https://rpc.nano.to', {
  "action": "market_data"
}).then((res) => {
  console.log(res.data);
});
Response
{
  "source": "coingecko.com",
  "id": "nano",
  "symbol": "xno",
  "name": "Nano",
  "hashing_algorithm": "Directed Acyclic Graph (DAG)",
  "categories": [
    "Cryptocurrency"
  ],
  "public_notice": "Nano has rebranded to a new ticker $XNO. Read more at: https://medium.com/@nanocurrency/say-hello-to-xno-7ed55e419e3f",
  "links": {
    "homepage": [
      "https://nano.org/en"
    ],
    "blockchain_site": [
      "https://nanolooker.com/"
    ],
    "official_forum_url": [
      "https://medium.com/nanocurrency"
    ],
    "chat_url": [
      "https://discordapp.com/invite/Jph***",
      "https://chat.nano.org/"
    ],
    "announcement_url": [
      "https://nanoticker.info/",
      "https://nault.cc/"
    ],
    "twitter_screen_name": "nano",
    "facebook_username": "nanofoundation",
    "bitcointalk_thread_identifier": null,
    "telegram_channel_identifier": "nanocurrency",
    "subreddit_url": "https://www.reddit.com/r/nanocurrency",
    "repos_url": {
      "github": [
        "https://github.com/nanocurrency/raiblocks"
      ],
      "bitbucket": []
    }
  },
  "image": {
    "thumb": "https://assets.coingecko.com/coins/images/756/thumb/nano.png?1637232468",
    "small": "https://assets.coingecko.com/coins/images/756/small/nano.png?1637232468",
    "large": "https://assets.coingecko.com/coins/images/756/large/nano.png?1637232468"
  },
  "sentiment_votes_up_percentage": 60,
  "sentiment_votes_down_percentage": 40,
  "watchlist_portfolio_users": 48007,
  "market_cap_rank": 263,
  "coingecko_rank": 33,
  "coingecko_score": 53.169,
  "developer_score": 86.2,
  "community_score": 45.614,
  "liquidity_score": 38.51,
  "public_interest_score": 0.004,
  "market_data": {
    "current_price": {
      "btc": 0.00002341,
      "usd": 0.704173
    },
    "total_value_locked": null,
    "mcap_to_tvl_ratio": null,
    "fdv_to_tvl_ratio": null,
    "roi": null,
    "ath": {},
    "ath_change_percentage": {},
    "ath_date": {},
    "atl": {},
    "atl_change_percentage": {},
    "atl_date": {},
    "market_cap": {},
    "market_cap_rank": 263,
    "fully_diluted_valuation": {},
    "total_volume": {},
    "high_24h": {},
    "low_24h": {},
    "price_change_24h": -0.004395865597632,
    "price_change_percentage_24h": -0.62039,
    "price_change_percentage_7d": 3.88828,
    "price_change_percentage_14d": 3.28418,
    "price_change_percentage_30d": -11.80108,
    "price_change_percentage_60d": -9.46265,
    "price_change_percentage_200d": 1.74205,
    "price_change_percentage_1y": -17.43601,
    "market_cap_change_24h": -529418.1285252,
    "market_cap_change_percentage_24h": -0.56125,
    "price_change_24h_in_currency": {},
    "price_change_percentage_1h_in_currency": {},
    "price_change_percentage_24h_in_currency": {},
    "price_change_percentage_7d_in_currency": {},
    "price_change_percentage_14d_in_currency": {},
    "price_change_percentage_30d_in_currency": {},
    "price_change_percentage_60d_in_currency": {},
    "price_change_percentage_200d_in_currency": {},
    "price_change_percentage_1y_in_currency": {},
    "market_cap_change_24h_in_currency": {},
    "market_cap_change_percentage_24h_in_currency": {},
    "total_supply": 133248290,
    "max_supply": 133248290,
    "circulating_supply": 133248290,
    "last_updated": "2023-07-06T14:41:51.470Z"
  },
  "public_interest_stats": {
    "alexa_rank": 313412,
    "bing_matches": null
  },
  "status_updates": [
    {
      "description": "In the lead up to Follis V23, get up to speed with the software improvements that will allow for faster and more stable development.\r\n\r\nFeatures include:\r\n🔹 Node initialisation parameter redesign\r\n🔹 Ledger constraints\r\n🔹 New naming conventions\r\n🔹 Updated integration docs\r\n\r\nhttps://blog.nano.org/v23-0-follis-development-update-55ef8c41cbb",
      "category": "general",
      "created_at": "2021-10-04T20:45:57.611Z",
      "user": "Naome Jones",
      "user_title": "Communications Manager",
      "pin": false,
      "project": {
        "type": "Coin",
        "id": "nano",
        "name": "Nano",
        "symbol": "xno",
        "image": {
          "thumb": "https://assets.coingecko.com/coins/images/756/thumb/nano.png?1637232468",
          "small": "https://assets.coingecko.com/coins/images/756/small/nano.png?1637232468",
          "large": "https://assets.coingecko.com/coins/images/756/large/nano.png?1637232468"
        }
      }
    },
    {
      "description": "The latest Nano Digest has hit the timeline.\r\nJoin us for a round-up of everything new in the NANO ecosystem.\r\n\r\nhttps://blog.nano.org/nano-digest-cyberfirst-cryptouk-coincloud-dcm-nowpayments-pos-nano-community-program-and-a86bacb45133 ",
      "category": "general",
      "created_at": "2021-10-02T18:26:04.434Z",
      "user": "Naome Jones",
      "user_title": "Communications Manager",
      "pin": false,
      "project": {
        "type": "Coin",
        "id": "nano",
        "name": "Nano",
        "symbol": "xno",
        "image": {
          "thumb": "https://assets.coingecko.com/coins/images/756/thumb/nano.png?1637232468",
          "small": "https://assets.coingecko.com/coins/images/756/small/nano.png?1637232468",
          "large": "https://assets.coingecko.com/coins/images/756/large/nano.png?1637232468"
        }
      }
    },
    {
      "description": "It is with great pride that we announce our support for Cyber First, an educational programme created by the National Cyber Security Centre to develop the UK's next generation of cyber professionals by helping young people aged 11-17 in the UK explore their passion for tech.\r\n\r\nFind out more about Cyber First here: https://www.ncsc.gov.uk/cyberfirst/overview\r\n",
      "category": "general",
      "created_at": "2021-10-01T10:27:55.398Z",
      "user": "Naome Jones",
      "user_title": "Communications Manager",
      "pin": false,
      "project": {
        "type": "Coin",
        "id": "nano",
        "name": "Nano",
        "symbol": "xno",
        "image": {
          "thumb": "https://assets.coingecko.com/coins/images/756/thumb/nano.png?1637232468",
          "small": "https://assets.coingecko.com/coins/images/756/small/nano.png?1637232468",
          "large": "https://assets.coingecko.com/coins/images/756/large/nano.png?1637232468"
        }
      }
    },
    {
      "description": "1 HOUR TO GO until the Fintech & FS Group: Communicating crypto in 2021 event!\r\n\r\nCheck out the impressive lineup of speakers including George Coxon of Nano Foundation, Roopa Ramaiya of Luno, Elliott Suthers of Coinbase, Christian Williams of Crypto Briefing, Samantha Yap of YAP Global Ltd.\r\n\r\nHosted by the PRCA.\r\n\r\nREGISTER HERE: https://www.prca.org.uk/event/4944/communicating-crypto-in-2021%3A-how-to-talk-crypto-without-alienating-traditional-financial-audiences",
      "category": "general",
      "created_at": "2021-09-09T13:39:22.682Z",
      "user": "Naome Jones",
      "user_title": "Communications Manager",
      "pin": false,
      "project": {
        "type": "Coin",
        "id": "nano",
        "name": "Nano",
        "symbol": "xno",
        "image": {
          "thumb": "https://assets.coingecko.com/coins/images/756/thumb/nano.png?1637232468",
          "small": "https://assets.coingecko.com/coins/images/756/small/nano.png?1637232468",
          "large": "https://assets.coingecko.com/coins/images/756/large/nano.png?1637232468"
        }
      }
    },
    {
      "description": "You can now buy and sell NANO with INR & USDT on Indian exchange Koinbazar\r\n\r\nhttps://www.koinbazar.com/blog/buy-sell-trade-nano-on-koinbazar",
      "category": "general",
      "created_at": "2021-08-16T15:50:16.901Z",
      "user": "Naome Jones",
      "user_title": "Communications Manager",
      "pin": false,
      "project": {
        "type": "Coin",
        "id": "nano",
        "name": "Nano",
        "symbol": "xno",
        "image": {
          "thumb": "https://assets.coingecko.com/coins/images/756/thumb/nano.png?1637232468",
          "small": "https://assets.coingecko.com/coins/images/756/small/nano.png?1637232468",
          "large": "https://assets.coingecko.com/coins/images/756/large/nano.png?1637232468"
        }
      }
    },
    {
      "description": "That's right, your Friday just got a whole lot better! \r\nThe latest Nano Digest just dropped. Join us as we catch up on everything new in the Nano ecosystem.\r\n\r\nhttps://medium.com/nanocurrency/nano-digest-nano-on-airtm-p2p-new-partnerships-team-updates-media-moments-charitable-252b42ea44a7\r\n",
      "category": "general",
      "created_at": "2021-07-16T16:26:50.772Z",
      "user": "Naome Jones",
      "user_title": "Communications Manager",
      "pin": false,
      "project": {
        "type": "Coin",
        "id": "nano",
        "name": "Nano",
        "symbol": "xno",
        "image": {
          "thumb": "https://assets.coingecko.com/coins/images/756/thumb/nano.png?1637232468",
          "small": "https://assets.coingecko.com/coins/images/756/small/nano.png?1637232468",
          "large": "https://assets.coingecko.com/coins/images/756/large/nano.png?1637232468"
        }
      }
    },
    {
      "description": "Great news Argentina & Venezuela! NANO is now available on the Airtm P2P Marketplace!\r\n\r\nhttps://medium.com/nanocurrency/nano-is-now-available-on-airtm-p2p-marketplace-28ad9acfc856",
      "category": "general",
      "created_at": "2021-07-08T16:41:33.669Z",
      "user": "Naome Jones",
      "user_title": "Communications Manager",
      "pin": false,
      "project": {
        "type": "Coin",
        "id": "nano",
        "name": "Nano",
        "symbol": "xno",
        "image": {
          "thumb": "https://assets.coingecko.com/coins/images/756/thumb/nano.png?1637232468",
          "small": "https://assets.coingecko.com/coins/images/756/small/nano.png?1637232468",
          "large": "https://assets.coingecko.com/coins/images/756/large/nano.png?1637232468"
        }
      }
    }
  ],
  "last_updated": "2023-07-06T14:41:51.470Z"
}
nano_to_raw
Converts Nano currency amount (in Nano) to its raw value.
Axios
const axios = require('axios');

axios.post('https://rpc.nano.to', {
  "action": "nano_to_raw"
}).then((res) => {
  console.log(res.data);
});
Response
{
  "raw_value": "1000000000000000000000000"
}
price
Returns the current price information for Nano cryptocurrency.
Attributes
currency string

Valid ISO currency symbol.

Axios
const axios = require('axios');

axios.post('https://rpc.nano.to', {
  "action": "price",
  "currency": "EUR"
}).then((res) => {
  console.log(res.data);
});
Response
{
  "symbol": "xno",
  "currency": "eur",
  "price": 1.019,
  "timestamp": "January 17, 2024 1:36 PM",
  "timestamp_unix": 1705516615,
  "source": "coingecko.com"
}
process
Processes a block and performs validation and state transition for the account.
Axios
const axios = require('axios');

axios.post('https://rpc.nano.to', {
  "action": "process",
  "json_block": "true",
  "subtype": "send",
  "block": {
    "type": "state",
    "account": "nano_1qato4k7z3spc8gq1zyd8xeqfbzsoxwo36a45ozbrxcatut7up8ohyardu1z",
    "previous": "6CDDA48608C7843A...EAC23E7F33F2E6A6766",
    "representative": "nano_3pczxuorp48td8645bs3m6c3xotxd3idskrenmi65rbrga5zmkemzhwkaznh",
    "balance": "40200000001000000000000000000000000",
    "link": "87434F8041869A0...7D7A3FD0CCC2358FD6F9",
    "link_as_account": "nano_33t5by1653nt196hfwm5q3wq7oxtaix97r7bhox5zn8eratrzoqsny49ftsd",
    "signature": "A5DB164F6B81648533900C3...ED4DCBF8EF2539EB2467F07",
    "work": "000bc55b014e807d"
  }
}).then((res) => {
  console.log(res.data);
});
Response
{
  "hash": "7D27B311666C8...6C8637D277F1FD2ED"
}
raw_to_nano
Converts raw value to Nano currency amount (in Nano).
Axios
const axios = require('axios');

axios.post('https://rpc.nano.to', {
  "action": "raw_to_nano"
}).then((res) => {
  console.log(res.data);
});
Response
{
  "nano_value": "1"
}
receivable
Returns the list of pending receivable blocks for the account, which are ready to be received.
Attributes
account string

Public Nano address or Nano.to @Username

count number

Limit amount of blocks. Max 1000. Contact us for higher limits.

Axios
const axios = require('axios');

axios.post('https://rpc.nano.to', {
  "action": "receivable",
  "account": "@faucet",
  "count": "5"
}).then((res) => {
  console.log(res.data);
});
Response
[
  {
    "hash": "9DA74CCE700808EB4BB91DB43F42E739244B0FD5F2BB0D00B2C7F9074C367E83",
    "source": "nano_38gxz93y39yqbeqkcgcyrhkyu183otfpaymjcstzsa9isp9epdsudhmf9shm",
    "amount": "100000000000000000000000000000",
    "amount_nano": "0.1"
  },
  {
    "hash": "A12FC2862F07F1CEFF8C848C8AD5B13E41578959C526588B5940CAA27B7B215E",
    "source": "nano_16ouai59d7eu4mnd9rxojncey65p1d5r3oipxyn1ceqgjkxtx8n5hxremooi",
    "amount": "1000000000000000000000000000",
    "amount_nano": "0.001"
  },
  {
    "hash": "C11BC728B8007CC875AA75040E8563C2C9195BAEE0A3CA424E98D089F7A336F5",
    "source": "nano_3qx5cz95xxpd5wsm9imggxpuxhpf5oupx14456ms5f5hn9qhyexiszfhshfb",
    "amount": "1000971397140000000000000000",
    "amount_nano": "0.00100097139714",
    "username": "lorem"
  }
]
reps
Returns a list of representatives (delegates) for voting on the Nano network.
Axios
const axios = require('axios');

axios.post('https://rpc.nano.to', {
  "action": "reps"
}).then((res) => {
  console.log(res.data);
});
Response
{
  "representatives": [
    "nano_rep1...",
    "nano_rep2..."
  ]
}
rep_info
Returns detailed information about a specific representative (delegate).
Axios
const axios = require('axios');

axios.post('https://rpc.nano.to', {
  "action": "rep_info"
}).then((res) => {
  console.log(res.data);
});
Response
{
  "info": {
    "account": "nano_rep1...",
    "online": true,
    "uptime": "98%",
    "voting_power": "5%"
  }
}
update_name
Updating names is free, because you pay your own address.
Attributes
name string

Your username to update.

Axios
const axios = require('axios');

axios.post('https://rpc.nano.to', {
  "action": "update_name",
  "name": "NanoBull"
}).then((res) => {
  console.log(res.data);
});
Response
{
  "address": "nano_37y6iq8m1zx...9jrcwhkmoxpo61f4o",
  "browser": "http://nano.to/pay_f2b27af7",
  "check": "https://api.nano.to/check/f2b27af7",
  "update_name": "@NanoBull",
  "amount": "0.00884"
}
version

Returns version information for RPC, Store, Protocol (network), Node (Major & Minor version).

Since version 20.0 also returns the Network label and identifier (hash of the genesis open block), and Build Info.

Since version 21.0 also returns Database backend information.

RPC Version always returns "1" as of 01/11/2018

Axios
const axios = require('axios');

axios.post('https://rpc.nano.to', {
  "action": "version"
}).then((res) => {
  console.log(res.data);
});
Response
{
  "rpc_version": "1",
  "store_version": "22",
  "protocol_version": "19",
  "node_vendor": "Nano V25.0",
  "store_vendor": "LMDB 0.9.25",
  "network": "live"
}
work_generate

Generates proof of work for a given block hash and difficulty threshold.

RPC API Key Required: Get Free API Key

Attributes
hash string

Nano block hash. If first block, use account_key.

api_key string required

Nano.to API Key. Can be passed via Authorization header as well.

Axios
const axios = require('axios');

axios.post('https://rpc.nano.to', {
  "action": "work_generate",
  "hash": ":FRONTIER",
  "api_key": "YOUR_RPC_KEY"
}).then((res) => {
  console.log(res.data);
});
Response
{
  "difficulty": "fffffff800000000",
  "multiplier": "1.4403398628545552",
  "work": "4e278d4edc807508",
  "frontier": "7D27B311666C82....6C8637D277F1FD2ED",
  "duration": "0.883s",
  "credits": 9,
  "cached": false
}