NEOSCAN API

Main API for accessing data from the explorer. All data is provided through GET requests in /api/test_net/v1.

API v1

Get address transactions summary

GET https://neoscan-testnet.io/api/test_net/v1/get_address_abstracts/address/page
Responses200400
Body
{
  "total_pages": 1,
  "total_entries": 9,
  "page_size": 15,
  "page_number": 1,
  "entries": [
    {
      "txid": "54c1f2e87530fa6de075cd06806f6ca3263a8656c0ba2829fd9c6a63495c16c4",
      "time": 1534236224,
      "block_height": 314,
      "asset": "602c79718b16e442de58778e148d0b1084e3b2dffd5de6b7b16cee7969282de7",
      "amount": "5",
      "address_to": "AvWB6afmnX4kJH43jnmthhbtbFHDYdSmhrt3QM6CechA",
      "address_from": "network_fees"
    },
    {
      "txid": "5f41870e4d05a8b43a6645deb38903489e303509385cfff2c6aa3be0d427af97",
      "time": 1534236224,
      "block_height": 309,
      "asset": "602c79718b16e442de58778e148d0b1084e3b2dffd5de6b7b16cee7969282de7",
      "amount": "0.2",
      "address_to": "fees",
      "address_from": "AvWB6afmnX4kJH43jnmthhbtbFHDYdSmhrt3QM6CechA"
    },
    {
      "txid": "4bff6509c7c23b4d6d9a5f58c97826945dfbd41fbbac43774f24522731e326c4",
      "time": 1534236224,
      "block_height": 308,
      "asset": "65b5600eb520c3cd7200bdfb171e75f1550d34ef5b75400a3d361a7e6754a3ef",
      "amount": "18",
      "address_to": "burn",
      "address_from": "AvWB6afmnX4kJH43jnmthhbtbFHDYdSmhrt3QM6CechA"
    },
    {
      "txid": "d15ae1d6b8565695568f3325428a1ebddfab0a0add24f1b5fbed84e2bd711615",
      "time": 1534236224,
      "block_height": 307,
      "asset": "65b5600eb520c3cd7200bdfb171e75f1550d34ef5b75400a3d361a7e6754a3ef",
      "amount": "18",
      "address_to": "AvWB6afmnX4kJH43jnmthhbtbFHDYdSmhrt3QM6CechA",
      "address_from": "mint"
    },
    {
      "txid": "aacd4284a78bc6423ff7f5a6a450d9f1cdec0ca9387e413de8023f52ccc68531",
      "time": 1534236224,
      "block_height": 300,
      "asset": "65b5600eb520c3cd7200bdfb171e75f1550d34ef5b75400a3d361a7e6754a3ef",
      "amount": "1",
      "address_to": "GQKdf1LAAwqFCwAWAihy79wow1av9rtomzSob31zxZjM",
      "address_from": "AvWB6afmnX4kJH43jnmthhbtbFHDYdSmhrt3QM6CechA"
    },
    {
      "txid": "db8349dc8116280249b27f5813e8928d4245884b20da48e05a3cc2adae55d66e",
      "time": 1534236224,
      "block_height": 293,
      "asset": "65b5600eb520c3cd7200bdfb171e75f1550d34ef5b75400a3d361a7e6754a3ef",
      "amount": "14",
      "address_to": "AvWB6afmnX4kJH43jnmthhbtbFHDYdSmhrt3QM6CechA",
      "address_from": "db8349dc8116280249b27f5813e8928d4245884b20da48e05a3cc2adae55d66e"
    },
    {
      "txid": "3e8df4a8f274154808362c6b87f2e99cee1d07a01487714a37de288c471ca9bb",
      "time": 1534236224,
      "block_height": 285,
      "asset": "65b5600eb520c3cd7200bdfb171e75f1550d34ef5b75400a3d361a7e6754a3ef",
      "amount": "5",
      "address_to": "84yw7xn8zyZ6YrD41ipieiGKnRENP55rvtfA4pATxgeq",
      "address_from": "AvWB6afmnX4kJH43jnmthhbtbFHDYdSmhrt3QM6CechA"
    },
    {
      "txid": "b566a544cd32a1ea3dd94ae4ba219e26f07bdf526cc530ba2728c12899d2a418",
      "time": 1534236224,
      "block_height": 276,
      "asset": "65b5600eb520c3cd7200bdfb171e75f1550d34ef5b75400a3d361a7e6754a3ef",
      "amount": "5",
      "address_to": "AvWB6afmnX4kJH43jnmthhbtbFHDYdSmhrt3QM6CechA",
      "address_from": "BBp4u3MXaHqXWgeiLdpGa4NgKioxG2ivweEg65UJ6nWo"
    },
    {
      "txid": "17b64306983104c355d26e8a72889e67d7cf27061c16ef3a18712cbfedc5fd52",
      "time": 1534236224,
      "block_height": 269,
      "asset": "602c79718b16e442de58778e148d0b1084e3b2dffd5de6b7b16cee7969282de7",
      "amount": "5.1",
      "address_to": "AvWB6afmnX4kJH43jnmthhbtbFHDYdSmhrt3QM6CechA",
      "address_from": "claim"
    }
  ]
}
Body
{
  "errors": [
    "page is not a valid integer",
    "address is not a valid base58"
  ]
}

Get address transactions summary
GET/api/test_net/v1/get_address_abstracts/{address}/{page}

Returns transaction summary an address from its hash, paginated

URI Parameters
HideShow
address
string (required) 

base 58 address

page
integer (required) 

page


Get address pair transactions summary

GET https://neoscan-testnet.io/api/test_net/v1/get_address_to_address_abstracts/address1/address2/page
Responses200400
Body
{
  "total_pages": 1,
  "total_entries": 2,
  "page_size": 15,
  "page_number": 1,
  "entries": [
    {
      "txid": "200a2f4cccc48dbe5e14d7bf0643a3f37bfb00d08528914eeeac4a429f983f80",
      "time": 1534236224,
      "block_height": 359,
      "asset": "b8ebb5dbe1477fb34260327ab14883a4c7c831af34993bf86cd3669e90bb68f3",
      "amount": "5",
      "address_to": "3qNnv8XDnqXC3Feh2U8cG7ZWzWkQMYtN84EJxSp362Zu",
      "address_from": "Exu1uFAwvKXXMbC7UAXpEMcN44NWYvsTGqDZbUcBCSgA"
    },
    {
      "txid": "d47c156355757f558b27a0b6b7c895eced008b8aa25784a8f49e6190cc003d62",
      "time": 1534236224,
      "block_height": 351,
      "asset": "b8ebb5dbe1477fb34260327ab14883a4c7c831af34993bf86cd3669e90bb68f3",
      "amount": "5",
      "address_to": "Exu1uFAwvKXXMbC7UAXpEMcN44NWYvsTGqDZbUcBCSgA",
      "address_from": "3qNnv8XDnqXC3Feh2U8cG7ZWzWkQMYtN84EJxSp362Zu"
    }
  ]
}
Body
{
  "errors": [
    "page is not a valid integer",
    "address2 is not a valid base58",
    "address1 is not a valid base58"
  ]
}

Get address pair transactions summary
GET/api/test_net/v1/get_address_to_address_abstracts/{address1}/{address2}/{page}

Returns transaction summary between two address from their hash, paginated

URI Parameters
HideShow
address1
string (required) 

base 58 address

address2
string (required) 

base 58 address

page
integer (required) 

page


Get all neo nodes

GET https://neoscan-testnet.io/api/test_net/v1/get_all_nodes
Responses200
Body
[
  {
    "url": "http://seed1.cityofzion.io:8080",
    "height": 2399999
  },
  {
    "url": "http://seed2.cityofzion.io:8080",
    "height": 2399999
  },
  {
    "url": "http://seed3.cityofzion.io:8080",
    "height": 2399999
  },
  {
    "url": "http://seed4.cityofzion.io:8080",
    "height": 2399999
  },
  {
    "url": "http://seed5.cityofzion.io:8080",
    "height": 2399999
  }
]

Get all neo nodes
GET/api/test_net/v1/get_all_nodes

Returns all working nodes and their respective heights. Information is updated each minute.


Get address balance

GET https://neoscan-testnet.io/api/test_net/v1/get_balance/address
Responses200400
Body
{
  "balance": [
    {
      "unspent": [
        {
          "value": 5,
          "txid": "a102125170dd7633f23151db91d471c4fa0e567d69e468180cd2da0e21b09023",
          "n": 349
        },
        {
          "value": 2,
          "txid": "53a554bb46d5c3df0d6e6fd0104dc38b977fd09df5ebd96041d48d71ba525564",
          "n": 343
        }
      ],
      "asset": "NEO",
      "amount": 7
    },
    {
      "unspent": [],
      "asset": "My Token",
      "amount": 2
    }
  ],
  "address": "GZMTgABZGW5cZ58fWYm5rnitJaRxYC22onh6vkZW2x4k"
}
Body
{
  "errors": [
    "address is not a valid base58"
  ]
}

Get address balance
GET/api/test_net/v1/get_balance/{address}

Returns the balance for an address including NEP5 Tokens.

URI Parameters
HideShow
address
string (required) 

base 58 address


Get block

GET https://neoscan-testnet.io/api/test_net/v1/get_block/block_hash
Responses200400404
Body
{
  "version": 2,
  "tx_count": 0,
  "transfers": [
    "e5f8bd4af3601b88a9dc974d07781c37df35c2e59c7a46b7f5411d4103cec1b7"
  ],
  "transactions": [
    "2a861a22edef878c9e70381a52f3b1667dcd938617686abc30e870cd0ef33c4e"
  ],
  "time": 1534236224,
  "size": 1526,
  "script": {
    "invocation": "BA3D53FDD3DF3C56248A298F08C1539A8B4F885E45157AD87004AC071403D5A3"
  },
  "previousblockhash": "",
  "nonce": "99917b54a2b6d07c82193cbb8d2a93adda0fbf34643b2c5848cbb10ed9d0c42a",
  "nextconsensus": "28ea66a2be02b35352d18a8c58bebfb7c71f6442f659c6b8979f0fbf47e676fc",
  "nextblockhash": "",
  "merkleroot": "df8c322d2f89838aa3cdd836400894e9345e419e6359b778c12138c53c2421d4",
  "index": 397,
  "hash": "bb8172a5042fb8e3e94db71ea9aea6ad478096a6239103f04092f7becfadcf06",
  "confirmations": 1
}
Body
{
  "errors": [
    "block_hash is not a valid integer_or_base16"
  ]
}
Body
{
  "errors": [
    "object not found"
  ]
}

Get block
GET/api/test_net/v1/get_block/{block_hash}

Returns the block model from its hash or index

URI Parameters
HideShow
block_hash
string (required) 

base 16 block hash


Get address claimable transactions

GET https://neoscan-testnet.io/api/test_net/v1/get_claimable/address
Responses200400
Body
{
  "unclaimed": 0.00000168,
  "claimable": [
    {
      "value": 2,
      "unclaimed": 4.8e-7,
      "txid": "ac9409a55e6d7da90ad74dab831f660eec4f43cabffc0a0b972cef67e3551f5b",
      "sys_fee": 0,
      "start_height": 5,
      "n": 339,
      "generated": 4.8e-7,
      "end_height": 8
    },
    {
      "value": 5,
      "unclaimed": 0.0000012,
      "txid": "b64fdab5eb8acce8e5f651d2d833fb7a06121c764e441ab6bb0465be4e6b417b",
      "sys_fee": 0,
      "start_height": 3,
      "n": 330,
      "generated": 0.0000012,
      "end_height": 6
    }
  ],
  "address": "383n1j9LZ2duBrt7xopXWbzTTmGm2QqhyJsjqu2hx444"
}
Body
{
  "errors": [
    "address is not a valid base58"
  ]
}

Get address claimable transactions
GET/api/test_net/v1/get_claimable/{address}

Returns the AVAILABLE claimable transactions for an address, from its hash.

URI Parameters
HideShow
address
string (required) 

base 58 address


Get address claimed transactions

GET https://neoscan-testnet.io/api/test_net/v1/get_claimed/address
Responses200400
Body
{
  "claimed": [
    {
      "txids": [
        "f9c5971c26a9033b58daf1fcc8159caf9aca7b731aafee8c97e5a2a141ce8fe8"
      ]
    },
    {
      "txids": [
        "712aafc8bf9781f7496c2cd27b2f6838551f32ffe353321cc29b189e5064bdc2",
        "6eb7399c4352e9f6309e59b3910edacd1198864819ce76a26ec225913a720df6"
      ]
    }
  ],
  "address": "8dPZRujs7QmuhCRC55BgtNthFXPmE5bRN5vKWRYjnDZn"
}
Body
{
  "errors": [
    "address is not a valid base58"
  ]
}

Get address claimed transactions
GET/api/test_net/v1/get_claimed/{address}

Returns the claimed transactions for an address, from its hash

URI Parameters
HideShow
address
string (required) 

base 58 address


Get last block index

GET https://neoscan-testnet.io/api/test_net/v1/get_height
Responses200
Body
{
  "height": 155
}

Get last block index
GET/api/test_net/v1/get_height

Returns latest block index of the neoscan db.


Get address last transactions

GET https://neoscan-testnet.io/api/test_net/v1/get_last_transactions_by_address/address/page
Responses400
Body
{
  "errors": [
    "page is not a valid integer",
    "address is not a valid base58"
  ]
}

Get address last transactions
GET/api/test_net/v1/get_last_transactions_by_address/{address}/{page}

Returns the last 15 transaction models in the chain for the selected address from its hash, paginated.

URI Parameters
HideShow
address
string (required) 

base 58 address

page
integer (optional) 

page index


Get transaction

GET https://neoscan-testnet.io/api/test_net/v1/get_transaction/transaction_hash
Responses200400404
Body
{
  "vouts": [
    {
      "value": 1.23,
      "txid": "f5a4463c528d0cb1d8a1d6cc73e924c2391e48dabc953365f3cbdec17bc5dd27",
      "n": 264,
      "asset": "truc",
      "address_hash": "2g4toQnF8uMHVC2AByHkgTkj23QwoudFQqvFEXcFZvft"
    }
  ],
  "vin": [
    {
      "value": 1.23,
      "txid": "ebe280cd4971ff98507167e7c2ee8485aed5ea34d10f35d8b3004aed61dcb32a",
      "n": 260,
      "asset": "truc",
      "address_hash": "BikuDvuVcahhDk7Sbq1G95XVVSxKRZgFJDKvaebfv7zH"
    }
  ],
  "version": 0,
  "type": "PublishTransaction",
  "txid": "f5a4463c528d0cb1d8a1d6cc73e924c2391e48dabc953365f3cbdec17bc5dd27",
  "time": 1534236224,
  "sys_fee": 0,
  "size": 123,
  "scripts": [],
  "pubkey": null,
  "nonce": null,
  "net_fee": 0,
  "description": null,
  "contract": null,
  "claims": [
    {
      "value": 1.23,
      "txid": "bf464d3a7b01d9cc4372a341ffce9317c4a267be290b214b3710f76c232eeef4",
      "n": 266,
      "asset": "e55fa5f13d3d0a745178e621c63767b2516f296c667ba6b1c616c329bcb04cd3",
      "address_hash": "A7ocknHDKVfapwufXRKdBHYzU13k9R4SoSHLVedmhRm7"
    }
  ],
  "block_height": 259,
  "block_hash": "213b3522e05e6637b90b4ad0cd38bdd906b83256d65f5ab861f34f99850fd0de",
  "attributes": [],
  "asset": null
}
Body
{
  "errors": [
    "transaction_hash is not a valid base16"
  ]
}
Body
{
  "errors": [
    "object not found"
  ]
}

Get transaction
GET/api/test_net/v1/get_transaction/{transaction_hash}

Returns the transaction model from its hash

URI Parameters
HideShow
transaction_hash
string (required) 

base 16 transaction hash


Get address unclaimed gas

GET https://neoscan-testnet.io/api/test_net/v1/get_unclaimed/address
Responses200400
Body
{
  "unclaimed": 0.0000032,
  "address": "Bwvsgb5Y21oBYE9dq79X6j1bW56yiVNLeu5PfYbh69pR"
}
Body
{
  "errors": [
    "address is not a valid base58"
  ]
}

Get address unclaimed gas
GET/api/test_net/v1/get_unclaimed/{address}

Returns the unclaimed gas for an address from its hash.

URI Parameters
HideShow
address
string (required) 

base 58 address


Generated by aglio on 14 Aug 2018