ACMSCAN API

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

API v1

Get address transactions summary

GET https://acmscan.mainnet.gcox.com/api/main_net/v1/get_address_abstracts/address/asset_hash/from/to/page
Responses200
Body
{
  "total_pages": 1,
  "total_entries": 9,
  "page_size": 15,
  "page_number": 1,
  "entries": [
    {
      "txid": "e6ec965dba13b604bd0a89d82486ef164d999f8d018c1e60c5d37482fe64a7ca",
      "time": 1569211263,
      "block_height": 788,
      "asset": "927c3f06f678b57031fc82a937985fc41ca29791049f04a14eab7a26c04a63a6",
      "amount": {
        "frozen": "0",
        "available": "5"
      },
      "address_to": "28gZguxFDRU7eEyLU7nUMjjKAR5qF56Xv74",
      "address_from": "network_fees"
    },
    {
      "txid": "c2eeef28ecffb165a1a4a07cad4649eceee1f61d6d063fcfe0ece9575f70834c",
      "time": 1569211263,
      "block_height": 778,
      "asset": "927c3f06f678b57031fc82a937985fc41ca29791049f04a14eab7a26c04a63a6",
      "amount": {
        "frozen": "0",
        "available": "0.2"
      },
      "address_to": "fees",
      "address_from": "28gZguxFDRU7eEyLU7nUMjjKAR5qF56Xv74"
    },
    {
      "txid": "821b61fbfd9a5fcd942c1ba5846b7e2844517cc44151e58a9ac7d450ef0d185f",
      "time": 1569211263,
      "block_height": 774,
      "asset": "ebc2123720a4bc63f8496e93e264910ca1515ac74843dddb7575f0e765d18432",
      "amount": {
        "frozen": "0",
        "available": "18"
      },
      "address_to": "burn",
      "address_from": "28gZguxFDRU7eEyLU7nUMjjKAR5qF56Xv74"
    },
    {
      "txid": "65d6e6e4173d3090fa7204673657646038e93dcf746c29bb2a43467007974055",
      "time": 1569211263,
      "block_height": 770,
      "asset": "ebc2123720a4bc63f8496e93e264910ca1515ac74843dddb7575f0e765d18432",
      "amount": {
        "frozen": "0",
        "available": "18"
      },
      "address_to": "28gZguxFDRU7eEyLU7nUMjjKAR5qF56Xv74",
      "address_from": "mint"
    },
    {
      "txid": "c76cc346effe4edd976b65286256d08936db7c5a41050991b1bfac08528ba7f8",
      "time": 1569211263,
      "block_height": 757,
      "asset": "ebc2123720a4bc63f8496e93e264910ca1515ac74843dddb7575f0e765d18432",
      "amount": {
        "frozen": "0",
        "available": "1"
      },
      "address_to": "a7hgWyM4KBEfymjB5RStRn5RaT5N1ivnzW",
      "address_from": "28gZguxFDRU7eEyLU7nUMjjKAR5qF56Xv74"
    },
    {
      "txid": "9cc7743f52d7030c690b44e76463a3347b044f8e967c0d6d7a0956fcb07fe236",
      "time": 1569211263,
      "block_height": 743,
      "asset": "ebc2123720a4bc63f8496e93e264910ca1515ac74843dddb7575f0e765d18432",
      "amount": {
        "frozen": "0",
        "available": "14"
      },
      "address_to": "28gZguxFDRU7eEyLU7nUMjjKAR5qF56Xv74",
      "address_from": "9cc7743f52d7030c690b44e76463a3347b044f8e967c0d6d7a0956fcb07fe236"
    },
    {
      "txid": "007a8b1420a6a252780643951f78ac7b042952a73f3f7293d5d6c3d31a739e59",
      "time": 1569211263,
      "block_height": 727,
      "asset": "ebc2123720a4bc63f8496e93e264910ca1515ac74843dddb7575f0e765d18432",
      "amount": {
        "frozen": "0",
        "available": "50"
      },
      "address_to": "JVgW8RVLPQA4VRSrD9433o8BPwyxAjhXtZ",
      "address_from": "28gZguxFDRU7eEyLU7nUMjjKAR5qF56Xv74"
    },
    {
      "txid": "f4867ca3600c08e35409110a6054244e48fb4f17fa2bfc8ce2962470ae47b4b1",
      "time": 1569211263,
      "block_height": 711,
      "asset": "ebc2123720a4bc63f8496e93e264910ca1515ac74843dddb7575f0e765d18432",
      "amount": {
        "frozen": "0",
        "available": "50"
      },
      "address_to": "28gZguxFDRU7eEyLU7nUMjjKAR5qF56Xv74",
      "address_from": "4gfSpoKtSBr8hQMPDxcA4k4pYebeMmwwxG"
    },
    {
      "txid": "1fd4b68fbdfda7d83cb393510db8cc513f9482a2c9c54f3e52ad811451607f45",
      "time": 1569211263,
      "block_height": 699,
      "asset": "927c3f06f678b57031fc82a937985fc41ca29791049f04a14eab7a26c04a63a6",
      "amount": {
        "frozen": "0",
        "available": "5.1"
      },
      "address_to": "28gZguxFDRU7eEyLU7nUMjjKAR5qF56Xv74",
      "address_from": "claim"
    }
  ]
}

Get address transactions summary
GET/api/main_net/v1/get_address_abstracts/{address}/{asset_hash}/{from}/{to}/{page}

Returns transaction summary an address from its hash, paginated

URI Parameters
HideShow
address
string (required) 

base 58 address

asset_hash
string (optional) 

base 16 asset hash

transaction_type
string (optional) 

one transaction type or more

from
integer (optional) 

UTC time from, required if passes parameter to, included

to
integer (optional) 

UTC time to, required if passes parameter from, excluded

page
integer (required) 

page


Get address pair transactions summary

GET https://acmscan.mainnet.gcox.com/api/main_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": "a695f3ba36415e02db1115f2394e1edeb2a27dd40c4bca13db8c10fcaaf9772b",
      "time": 1569211263,
      "block_height": 811,
      "asset": "0bf12ebc24fc1183bc0f4752f2f4a6478bbb7b25e428b83713373bd3de27320a",
      "amount": {
        "frozen": "0",
        "available": "5"
      },
      "address_to": "2cSoso5tSf2jtao2J17SYUJsa36VzTgpxGQ",
      "address_from": "2PciqTJxEu1W5A7mym7BSy87dEm1ktRVq1X"
    },
    {
      "txid": "32652c697eb242ed3d4e4f31c6e19899377757697644b97630d00c34b7bad334",
      "time": 1569211263,
      "block_height": 795,
      "asset": "0bf12ebc24fc1183bc0f4752f2f4a6478bbb7b25e428b83713373bd3de27320a",
      "amount": {
        "frozen": "0",
        "available": "5"
      },
      "address_to": "2PciqTJxEu1W5A7mym7BSy87dEm1ktRVq1X",
      "address_from": "2cSoso5tSf2jtao2J17SYUJsa36VzTgpxGQ"
    }
  ]
}
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/main_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://acmscan.mainnet.gcox.com/api/main_net/v1/get_all_nodes
Responses200
Body
[
  {
    "url": "https://json-rpc.mainnet.gcox.com:40331",
    "height": 2399999
  }
]

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

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


Get asset

GET https://acmscan.mainnet.gcox.com/api/main_net/v1/get_asset/asset_hash
Responses200
Body
{
  "type": "governing_token",
  "txid": "77ed6ec82f5c26e7dca0843589ebbec564498d1fc122e71610e3a94f3f8cef2e",
  "time": 1569211263,
  "symbol": "truc",
  "removed": false,
  "precision": 8,
  "owner": "e53c38d48a9cd3aafd6aa06ecbfe00937d3a5b356bc72640533c90f943ba5da0",
  "name": {
    "name": "ACM",
    "lang": "en"
  },
  "issued": 1,
  "contract": "e0a097fdd6493e535e32435b9e6b429c22e1f4ee965a023ebf0281100c7038ce",
  "amount": 5,
  "admin": "5iESDQ7tNoPfoWRbNP6BWLsJpF3mBXwNog7X5RdwUomH"
}

Get asset
GET/api/main_net/v1/get_asset/{asset_hash}

Returns the asset model from its hash

URI Parameters
HideShow
asset_hash
string (required) 

base 16 asset hash


Get the specific assets

GET https://acmscan.mainnet.gcox.com/api/main_net/v1/get_assets/category
Responses200
Body
[
  {
    "type": "token",
    "txid": "bab2a8d7bb35b1b524a81d6f66d6aa42dc52e6ec292c3584a3588ef46ddfb69c",
    "time": 1,
    "symbol": "truc",
    "removed": false,
    "precision": 8,
    "owner": "41f506b44c2a531ee64578b387165dfb8744583581262fd39d92e73c7994e861",
    "name": {
      "en": "truc"
    },
    "issued": 1,
    "contract": "644bf59a79971adf0e0957790d78bb8c135b112cb8bc48eb42ed7a69e55b85b6",
    "amount": 5,
    "admin": "Fum4NRDkuzbsFvWsdqFDSeqyPWR9997dWRFHZgeTw6eG"
  },
  {
    "type": "governing_token",
    "txid": "77ed6ec82f5c26e7dca0843589ebbec564498d1fc122e71610e3a94f3f8cef2e",
    "time": 0,
    "symbol": "truc",
    "removed": false,
    "precision": 8,
    "owner": "1cc9baf8f155ca3edd291a7ccfe25e2e5997899f20f5b0f079102dfe90ffd930",
    "name": {
      "name": "ACM",
      "lang": "en"
    },
    "issued": 1,
    "contract": "f8a77cdd9893f5b279d9a00b065bdcbedc0b8374fc25aa39d313b7a5852939d1",
    "amount": 5,
    "admin": "AdBPPSWERPyzrABtZ4BxmFgNvsJTBW5wzkvTBLHnjTp2"
  }
]

Get the specific assets
GET/api/main_net/v1/get_assets/{category}

Returns the specific assets

URI Parameters
HideShow
category
string (optional) Default: active 

the asset category

Choices: all active removed


Get address balance

GET https://acmscan.mainnet.gcox.com/api/main_net/v1/get_balance/address
Responses200400
Body
{
  "balance": [
    {
      "unspent": [
        {
          "value": 5,
          "txid": "6381aec2eb5bf1810acbd50cc7982016a9902d3e47b8200ea5e5d1afa76b6f2d",
          "n": 689
        },
        {
          "value": 2,
          "txid": "918300b7a48dec6c164f3405dce1e4b1088eac43107c0663534d7a80b9c522e2",
          "n": 679
        }
      ],
      "asset_symbol": "truc",
      "asset_hash": "77ed6ec82f5c26e7dca0843589ebbec564498d1fc122e71610e3a94f3f8cef2e",
      "asset": "ACM",
      "amount": {
        "frozen": 0,
        "available": 7
      }
    },
    {
      "unspent": [],
      "asset_symbol": "TKN",
      "asset_hash": "040506",
      "asset": "My Token",
      "amount": {
        "frozen": 0,
        "available": 2
      }
    }
  ],
  "address": "2PS7UMj14D7jqUKykD3DdrCua38QF6pCNri"
}
Body
{
  "errors": [
    "address is not a valid base58"
  ]
}

Get address balance
GET/api/main_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://acmscan.mainnet.gcox.com/api/main_net/v1/get_block/block_hash
Responses200400404
Body
{
  "version": 2,
  "tx_count": 0,
  "transfers": [
    "43b1ee73b76ea37367e0cd45563c9c28e17bc96754299e988982070f76577ecd"
  ],
  "transactions": [
    "43b1ee73b76ea37367e0cd45563c9c28e17bc96754299e988982070f76577ecd"
  ],
  "time": 1569211263,
  "size": 1526,
  "script": {
    "invocation": "7E513611CA07DAA71E88C450AFE624A18CC7B2B24EC6635D486AC2F0AECFB754"
  },
  "previousblockhash": "",
  "nonce": "2df43cba520797cab64c11ae0bf7dff419b2d5dd3a998138e4431ba8f53fd21d",
  "nextconsensus": "31b3ce9913289c68c92f9b63983b1c5f834c18fba446251eba55196ad786f0b8",
  "nextblockhash": "",
  "merkleroot": "4ac21a24c7917e3e0d5a931c50e69cb56a26a11514fb46fd774010e3427e2f31",
  "index": 823,
  "hash": "5a92f9fa66163218985df7867a7466597acf03f4fe4cc580bbb3ac6d264abf67",
  "confirmations": 1
}
Body
{
  "errors": [
    "block_hash is not a valid integer_or_base16"
  ]
}
Body
{
  "errors": [
    "object not found"
  ]
}

Get block
GET/api/main_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 claimed transactions

GET https://acmscan.mainnet.gcox.com/api/main_net/v1/get_claimed/address
Responses200400
Body
{
  "claimed": [
    {
      "txids": [
        "3e770dd681ff015f33081eef43d160ed63dbef01b52f807a5b01ca11000eb1de"
      ]
    },
    {
      "txids": [
        "1ff0a3c4b2b74d9b1c7f5a9bcf71e22939816133a2770a567faf87f83d4be5e4",
        "d8a997b30b38a1fc1f66f74e3a072f87f095d99c3355a65fd5bd6e4a37ed694f"
      ]
    }
  ],
  "address": "2U3h1VfR6iirCdHaTRV3Td4duKDkvkdqQZd"
}
Body
{
  "errors": [
    "address is not a valid base58"
  ]
}

Get address claimed transactions
GET/api/main_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://acmscan.mainnet.gcox.com/api/main_net/v1/get_height
Responses200
Body
{
  "height": 155
}

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

Returns latest block index of the neoscan db.


Get address last transactions

GET https://acmscan.mainnet.gcox.com/api/main_net/v1/get_last_transactions_by_address/address/page
Responses200400
Body
[
  {
    "vouts": [
      {
        "value": 1.23,
        "txid": "b95f2457067e2975b88d8db3e8d929168e45785fdcc355f4f5b19263934fc4c9",
        "n": 857,
        "asset": "79822e6ebe2657a3b8f7cdc1f555a4c27e04e4c2e73d9ce39b6942c89212dd12",
        "address_hash": "23C8yGDXaNegWza1f5gw4cci3zWyRHUZts3"
      }
    ],
    "vin": [
      {
        "value": 1.23,
        "txid": "99d05344788f1685356a02b8b38714d18f239e000f15890a60f2ff0b7dbab9bf",
        "n": 850,
        "asset": "79822e6ebe2657a3b8f7cdc1f555a4c27e04e4c2e73d9ce39b6942c89212dd12",
        "address_hash": "fhvW7F4zbnBiLN7yDwMgmVdMbtCpNkBDAK"
      }
    ],
    "version": 0,
    "type": "OrderCancellationSystemTransaction",
    "txid": "b95f2457067e2975b88d8db3e8d929168e45785fdcc355f4f5b19263934fc4c9",
    "time": 1569211263,
    "sys_fee": 0,
    "size": 123,
    "scripts": [],
    "pubkey": null,
    "nonce": null,
    "net_fee": 0,
    "description": null,
    "contract": null,
    "claims": [
      {
        "value": 1.23,
        "txid": "45eebc061adc0564eba0d89ab05592d4a9eb5e03ee9c4745045eff5a0b511f68",
        "n": 860,
        "asset": "79822e6ebe2657a3b8f7cdc1f555a4c27e04e4c2e73d9ce39b6942c89212dd12",
        "address_hash": "ewCp1z6gG7GR4UqzKvEiD4gfbLM8LEJrRp"
      }
    ],
    "block_height": 847,
    "block_hash": "735475d6714ceb218709838b9bb0384f72654d4ae980a5d8e05954a9fd229783",
    "attributes": [],
    "asset": null
  }
]
Body
{
  "errors": [
    "page is not a valid integer",
    "address is not a valid base58"
  ]
}

Get address last transactions
GET/api/main_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 trade history

GET https://acmscan.mainnet.gcox.com/api/main_net/v1/get_trade_history/address/market_hash/from/to/page
Responses200
Body
{
  "total_pages": 1,
  "total_entries": 1,
  "page_size": 15,
  "page_number": 1,
  "entries": [
    {
      "vouts": [
        {
          "value": 1,
          "txid": "a6f6db54096daf83f9ee2e54ec6ecb4c44236093489de5ceee93e57c0c3e506c",
          "n": 657,
          "asset": "2bb0c27c0904cc0d9243753e7ad39666d4f60630268375c8e93729b1248112a8",
          "address_hash": "2gSRniNgA8XtjdrV374BjdsHen6Q4H1mEbX"
        },
        {
          "value": 1,
          "txid": "0707881891a6c4e283d27c3db08c3d0a7057f18a451e6731d746d6befb0770a2",
          "n": 660,
          "asset": "3d7cc0c9a01891bac50c7344d63e18d6883776873a7556985a11b877c4dfbc2d",
          "address_hash": "DqHMM5KMmKN6GXKjcEgr95GaMLT3Er3rFY"
        }
      ],
      "vin": [
        {
          "value": 1,
          "txid": "4e64076fa91076c12707ac68f42a1524e02bf5511be0cf4557f4981437099867",
          "n": 663,
          "asset": "3d7cc0c9a01891bac50c7344d63e18d6883776873a7556985a11b877c4dfbc2d",
          "address_hash": "2gSRniNgA8XtjdrV374BjdsHen6Q4H1mEbX"
        },
        {
          "value": 1,
          "txid": "2603ac4a2565e4dda1f0945c82c85400340bc08c02d75c392b4387371a07f102",
          "n": 670,
          "asset": "2bb0c27c0904cc0d9243753e7ad39666d4f60630268375c8e93729b1248112a8",
          "address_hash": "DqHMM5KMmKN6GXKjcEgr95GaMLT3Er3rFY"
        }
      ],
      "version": 0,
      "type": "TradingTransaction",
      "txid": "fd0379ea9c16d04d3c19c624148318fecb27287f0aa61b4e5eeca3ebd0e7c978",
      "time": 1569211263,
      "sys_fee": 0,
      "size": 123,
      "scripts": [],
      "quantity": 1,
      "pubkey": null,
      "price": 1,
      "order_id_b": "01614461b413763503239fe275338656011a347608c65c894fa9c6e64bc540e8",
      "order_id_a": "3775ef698c3165d6134754488fba1e6d764e62e493d4fd3deb74b905d824ac73",
      "nonce": null,
      "net_fee": 0,
      "market_quote_asset_id": "2bb0c27c0904cc0d9243753e7ad39666d4f60630268375c8e93729b1248112a8",
      "market_id": "43483d60ad6fca3b570cc4973b18cd7f416a95f34d81547c58c5d94af6c09811",
      "market_base_asset_id": "3d7cc0c9a01891bac50c7344d63e18d6883776873a7556985a11b877c4dfbc2d",
      "description": null,
      "contract": null,
      "claims": [],
      "block_height": 654,
      "block_hash": "a36ef37aba875eb24620d7295c87044fe33f56cf9862de1137d3362fec5a9600",
      "attributes": [],
      "asset": null
    }
  ]
}

Get trade history
GET/api/main_net/v1/get_trade_history/{address}/{market_hash}/{from}/{to}/{page}

Returns 15 trade histories in the chain for the selected address, market and time range, paginated.

URI Parameters
HideShow
address
string (required) 

base 58 address or pseudo address global for all addresses

market_hash
string (optional) 

base 16 market hash

from
integer (optional) 

UTC time from, required if passes parameter to, included

to
integer (optional) 

UTC time to, required if passes parameter from, excluded

page
integer (required) 

page index


Get transaction

GET https://acmscan.mainnet.gcox.com/api/main_net/v1/get_transaction/transaction_hash
Responses200400404
Body
{
  "vouts": [
    {
      "value": 1.23,
      "txid": "e0e5742f027e018e667561e4e788eaa65799603e2708a63be51067b8953b4a0c",
      "n": 878,
      "asset": "e827939671443e0348fe4533901291b8ff7602f3082c32b80ee88f1900dd9b02",
      "address_hash": "2ESqvGUkK2mVinGHvEgjvN1B2JNn7h6b5oq"
    }
  ],
  "vin": [
    {
      "value": 1.23,
      "txid": "0153544eaf52fe480d2265d3c6754326219e9dcba926b7da731a07b9979dd293",
      "n": 871,
      "asset": "e827939671443e0348fe4533901291b8ff7602f3082c32b80ee88f1900dd9b02",
      "address_hash": "w9dQTdHEq36Ns6JaNxPtYG8Qv93bnDNYeF"
    }
  ],
  "version": 0,
  "type": "OrderCancellationSystemTransaction",
  "txid": "e0e5742f027e018e667561e4e788eaa65799603e2708a63be51067b8953b4a0c",
  "time": 1569211263,
  "sys_fee": 0,
  "size": 123,
  "scripts": [],
  "pubkey": null,
  "nonce": null,
  "net_fee": 0,
  "description": null,
  "contract": null,
  "claims": [
    {
      "value": 1.23,
      "txid": "08766afdf9ef76b249e7851538e76a60e2a489d0ea7f2101671578a68b22e645",
      "n": 881,
      "asset": "e827939671443e0348fe4533901291b8ff7602f3082c32b80ee88f1900dd9b02",
      "address_hash": "2AeGygRdVdTy1evRtsTSUwxosKJktwZcZMo"
    }
  ],
  "block_height": 868,
  "block_hash": "c3e23642049a7bcf1dfcba6f36a08b1569ebd6604995b63027c913c5c6c616e7",
  "attributes": [],
  "asset": null
}
Body
{
  "errors": [
    "transaction_hash is not a valid base16"
  ]
}
Body
{
  "errors": [
    "object not found"
  ]
}

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

Returns the transaction model from its hash

URI Parameters
HideShow
transaction_hash
string (required) 

base 16 transaction hash


Generated by aglio on 23 Sep 2019