# ViaWallet Developer Documentation


# Portal Instructions

# Notes

Endpoint: https://developers.viawallet.com/openapi/api

Unless otherwise noted, "BTC and other similar coins" supported by API include BTC, BCH, BSV, LTC, DASH, DOGE, ZEC, DCR, FCH, DGB, LBC, XEC, RVN, ZEN, HNS, CKB

"ETH and other similar coins" portals: ETH, ETC, BNB, HT, TRX, ONT, VET, ICX

"ATOM and other similar coins" portals: ATOM, KAVA, IRIS

The {coin} parameter in the URL corresponds to the lowercase abbreviation of each cryptocurrency.

All APIs will return the following json objects. If the error code is code=0, it means success. For other error codes, they all indicate failure, and the message will describe the cause of the error. "data" is a json object or array, null if returns empty.

{
  "code": 0,          // error code 
  "data": {},         // result of request, json object, array or null
  "message": "OK"     // cause of error
}

In particular, for the API that provides paging capability, the return format is as follows.

{
    "code": 0,
    "data": {
        "items": [],   // result array
        "limit": 10,   // quantity per page
        "nextkey": "", // Page turning cursor
        "page": 1      // Page number
    },
    "message": "OK"
}

For GET and DELETE requests, the request parameters should be placed in the url.

For POST and PUT requests, the request parameters should be a json string placed in the request body with the Content-Type: application/json request header.

All requests have the tonce parameter for signing. The tonce value is a timestamp accurate to the millisecond, to ensure that the timestamp is less than the server time, and the difference between the time and the server time is no more than 1 minute.

The statistical period of daily data returned by the API is from 0: 00 to 24:00, Beijing time (UTC+8).

# Authentication

Each account or sub-account has a pair of api key and private key, which can be found on the API Management (opens new window) page. api key is used to identify the user's identity while private key is used to sign to verify the user's identity, please do not disclose.

key value
api key BRfvZY97QaRa14Ci1F5vvP3KzwRxFFMw
private key mpEFG56Nc9u5fUFjrg9mWoTEe8uk343X

Each API requires authentication. The authentication method is to include the request header of X-API-KEY: <your_api_key> in the request. For example:

curl --location --request GET 'https://developers.viawallet.com/openapi/api/btc/v1/block?hashOrHeight=675871' -H 'X-API-KEY: 16289e05354c3c3814b8f3045950395f'

In addition to authentication, a signature is also required. The steps of signature and request are as follows:

  1. Combine the request url and tonce parameters into the following form:
/openapi/api/btc/v1/block?tonce=1513746038205
  1. Calculate the HMAC SHA256 signature of request url with the key private key:
echo -n '/openapi/api/btc/v1/webhook/addresses?tonce=1513746038205' | openssl dgst -sha256 -hmac "mpEFG56Nc9u5fUFjrg9mWoTEe8uk343X"
# output: 8c640807d23a80b32f52fbb163afaa677fb33d5b0784017cf47074594ff72f16
  1. In the request, bring the request header of X-API-KEY: <your_api_key> and X-SIGNATURE: < signature >. The "signature" is the signature calculated in the previous step, and the query string or request body of the previous step is used to make the request.
curl 'https://developers.viawallet.com/openapi/api/btc/v1/block?hashOrHeight=666666&tonce=1513746038205' -H 'X-API-KEY: BRfvZY97QaRa14Ci1F5vvP3KzwRxFFMw' -H 'X-SIGNATURE: 8c640807d23a80b32f52fbb163afaa677fb33d5b0784017cf47074594ff72f16'
Example Request
Example Response
200 OK

# Portal Instructions

# Notes

Endpoint: https://developers.viawallet.com/openapi/api

Unless otherwise noted, "BTC and other similar coins" supported by API include BTC, BCH, BSV, LTC, DASH, DOGE, ZEC, DCR, FCH, DGB, LBC, XEC, RVN, ZEN, HNS, CKB

"ETH and other similar coins" portals: ETH, ETC, BNB, HT, TRX, ONT, VET, ICX

"ATOM and other similar coins" portals: ATOM, KAVA, IRIS

The {coin} parameter in the URL corresponds to the lowercase abbreviation of each cryptocurrency.

All APIs will return the following json objects. If the error code is code=0, it means success. For other error codes, they all indicate failure, and the message will describe the cause of the error. "data" is a json object or array, null if returns empty.

{
  "code": 0,          // error code 
  "data": {},         // result of request, json object, array or null
  "message": "OK"     // cause of error
}

In particular, for the API that provides paging capability, the return format is as follows.

{
    "code": 0,
    "data": {
        "items": [],   // result array
        "limit": 10,   // quantity per page
        "nextkey": "", // Page turning cursor
        "page": 1      // Page number
    },
    "message": "OK"
}

For GET and DELETE requests, the request parameters should be placed in the url.

For POST and PUT requests, the request parameters should be a json string placed in the request body with the Content-Type: application/json request header.

All requests have the tonce parameter for signing. The tonce value is a timestamp accurate to the millisecond, to ensure that the timestamp is less than the server time, and the difference between the time and the server time is no more than 1 minute.

The statistical period of daily data returned by the API is from 0: 00 to 24:00, Beijing time (UTC+8).

# Authentication

Each account or sub-account has a pair of api key and private key, which can be found on the API Management (opens new window) page. api key is used to identify the user's identity while private key is used to sign to verify the user's identity, please do not disclose.

key value
api key BRfvZY97QaRa14Ci1F5vvP3KzwRxFFMw
private key mpEFG56Nc9u5fUFjrg9mWoTEe8uk343X

Each API requires authentication. The authentication method is to include the request header of X-API-KEY: <your_api_key> in the request. For example:

curl --location --request GET 'https://developers.viawallet.com/openapi/api/btc/v1/block?hashOrHeight=675871' -H 'X-API-KEY: 16289e05354c3c3814b8f3045950395f'

In addition to authentication, a signature is also required. The steps of signature and request are as follows:

  1. Combine the request url and tonce parameters into the following form:
/openapi/api/btc/v1/block?tonce=1513746038205
  1. Calculate the HMAC SHA256 signature of request url with the key private key:
echo -n '/openapi/api/btc/v1/webhook/addresses?tonce=1513746038205' | openssl dgst -sha256 -hmac "mpEFG56Nc9u5fUFjrg9mWoTEe8uk343X"
# output: 8c640807d23a80b32f52fbb163afaa677fb33d5b0784017cf47074594ff72f16
  1. In the request, bring the request header of X-API-KEY: <your_api_key> and X-SIGNATURE: < signature >. The "signature" is the signature calculated in the previous step, and the query string or request body of the previous step is used to make the request.
curl 'https://developers.viawallet.com/openapi/api/btc/v1/block?hashOrHeight=666666&tonce=1513746038205' -H 'X-API-KEY: BRfvZY97QaRa14Ci1F5vvP3KzwRxFFMw' -H 'X-SIGNATURE: 8c640807d23a80b32f52fbb163afaa677fb33d5b0784017cf47074594ff72f16'
Example Request
Example Response
200 OK

# Public Socket

This function is used to receive timely notification that the deposit/withdrawal (receiving/sending) transaction of the monitoring address is successfully connected to the chain. If a transaction occurs at the monitoring address and the balance changes, ViaWallet's back-end system will POST the transaction-related message to the Webhook URL you set through a webhook method.

# POST Set Webhook URL

/{coin}/v1/webhook/url
params type required note
address string yes address
webhook_url string yes callback url

Set the webhook URL. If a transaction occurs at the subscribed address and the balance changes, the back-end system of ViaWallet will call the URL you set and POST the message. After your server receives the notification, it must return 200 OK.

The message notifying POST of balance change is in JSON text and is formatted as follows

{
    "address":"1EaSi5xycF5Ufpy2uSvCbjtSfnVPgeCiaj",                             // address
    "tx_id":"df244cbc60f4220e5d90de0833b647bd7f376f5132314a1672dd9b5128302659", // transaction hash
    "date": 1612015420,                                                         // trading time (UTC)
    "confirmations": 1,                                                         // the number of confirmation of this transaction when the notice is first issued.
    "value": "-0.002135942",                                                    // balance change
    "coin": "BTC",                                                              // on which chain the transaction occurs
    "height": 10254665,                                                         // the block height where the transaction is packaged
}
Example Request
curl --location --request POST 'https://developers.viawallet.com/openapi/api/btc/v1/webhook/url' \
--header 'Content-Type: application/json' \
--data-raw '{address=1EaSi5xycF5Ufpy2uSvCbjtSfnVPgeCiaj,webhook_url=www.developers.viawallet.com}'
Example Response
200 OK
{
  "code": 0,
  "data": {},
  "message": "OK"
}

# Public Socket

This function is used to receive timely notification that the deposit/withdrawal (receiving/sending) transaction of the monitoring address is successfully connected to the chain. If a transaction occurs at the monitoring address and the balance changes, ViaWallet's back-end system will POST the transaction-related message to the Webhook URL you set through a webhook method.

# POST Set Webhook URL

/{coin}/v1/webhook/url
params type required note
address string yes address
webhook_url string yes callback url

Set the webhook URL. If a transaction occurs at the subscribed address and the balance changes, the back-end system of ViaWallet will call the URL you set and POST the message. After your server receives the notification, it must return 200 OK.

The message notifying POST of balance change is in JSON text and is formatted as follows

{
    "address":"1EaSi5xycF5Ufpy2uSvCbjtSfnVPgeCiaj",                             // address
    "tx_id":"df244cbc60f4220e5d90de0833b647bd7f376f5132314a1672dd9b5128302659", // transaction hash
    "date": 1612015420,                                                         // trading time (UTC)
    "confirmations": 1,                                                         // the number of confirmation of this transaction when the notice is first issued.
    "value": "-0.002135942",                                                    // balance change
    "coin": "BTC",                                                              // on which chain the transaction occurs
    "height": 10254665,                                                         // the block height where the transaction is packaged
}
Example Request
curl --location --request POST 'https://developers.viawallet.com/openapi/api/btc/v1/webhook/url' \
--header 'Content-Type: application/json' \
--data-raw '{address=1EaSi5xycF5Ufpy2uSvCbjtSfnVPgeCiaj,webhook_url=www.developers.viawallet.com}'
Example Response
200 OK
{
  "code": 0,
  "data": {},
  "message": "OK"
}

# DELETE Delete Webhook URL

/{coin}/v1/webhook/url

Delete the callback url of an address. An address can have multiple callback urls, you can choose to delete one of them.

params type required note
address string yes subscription address
webhook_url string yes callback url to be delete
Example Request
curl --location --request DELETE 'https://developers.viawallet.com/openapi/api/btc/v1/webhook/url?address=1EaSi5xycF5Ufpy2uSvCbjtSfnVPgeCiaj&webhook_url=www.developers.viawallet.com' \
Example Response
200 OK
{
    "code": 0,
    "data": {},
    "message": "OK"
}

# DELETE Delete Webhook URL

/{coin}/v1/webhook/url

Delete the callback url of an address. An address can have multiple callback urls, you can choose to delete one of them.

params type required note
address string yes subscription address
webhook_url string yes callback url to be delete
Example Request
curl --location --request DELETE 'https://developers.viawallet.com/openapi/api/btc/v1/webhook/url?address=1EaSi5xycF5Ufpy2uSvCbjtSfnVPgeCiaj&webhook_url=www.developers.viawallet.com' \
Example Response
200 OK
{
    "code": 0,
    "data": {},
    "message": "OK"
}

# POST Add Subscription Address

/{coin}/v1/webhook/address

To add a new subscription address, you need to specify the currency name, monitoring address, and callback URL. When calling back, the X-SIGNATURE header will be added, and the value of X-SIGNATURE will be set to the HMAC SHA256 signature made with secret {webhook_url}?tonce={timestamp}, Here webhook_url is the callback of the monitoring address, and timestamp is the timestamp in milliseconds. For example:

webhook_url: https://developers.viawallet.com
tonce: 1513746038205

echo -n 'https://developers.viawallet.com?tonce=1513746038205' | openssl dgst -sha256 -hmac "mpEFG56Nc9u5fUFjrg9mWoTEe8uk343X"
# output: b9d55b0c5385137611542f8b85178329e5cbec22cb0780f9d9c3ce07f778ba9f

# added header
X-SIGNATURE: b9d55b0c5385137611542f8b85178329e5cbec22cb0780f9d9c3ce07f778ba9f

params type required note
secret string yes used to sign
address string yes address
webhook_urls string yes separate each url with a comma
Example Request
curl --location --request POST 'https://developers.viawallet.com/openapi/api/btc/v1/webhook/address'\
--header 'Content-Type: application/json' \
--data-raw '{
    "address":"1EaSi5xycF5Ufpy2uSvCbjtSfnVPgeCiaj",
    "webhook_urls":"www.viawallet.com,www.coinex.org"
}'
Example Response
200 OK
{
  "code": 0,
  "data": {},
  "message": "OK"
}

# POST Add Subscription Address

/{coin}/v1/webhook/address

To add a new subscription address, you need to specify the currency name, monitoring address, and callback URL. When calling back, the X-SIGNATURE header will be added, and the value of X-SIGNATURE will be set to the HMAC SHA256 signature made with secret {webhook_url}?tonce={timestamp}, Here webhook_url is the callback of the monitoring address, and timestamp is the timestamp in milliseconds. For example:

webhook_url: https://developers.viawallet.com
tonce: 1513746038205

echo -n 'https://developers.viawallet.com?tonce=1513746038205' | openssl dgst -sha256 -hmac "mpEFG56Nc9u5fUFjrg9mWoTEe8uk343X"
# output: b9d55b0c5385137611542f8b85178329e5cbec22cb0780f9d9c3ce07f778ba9f

# added header
X-SIGNATURE: b9d55b0c5385137611542f8b85178329e5cbec22cb0780f9d9c3ce07f778ba9f

params type required note
secret string yes used to sign
address string yes address
webhook_urls string yes separate each url with a comma
Example Request
curl --location --request POST 'https://developers.viawallet.com/openapi/api/btc/v1/webhook/address'\
--header 'Content-Type: application/json' \
--data-raw '{
    "address":"1EaSi5xycF5Ufpy2uSvCbjtSfnVPgeCiaj",
    "webhook_urls":"www.viawallet.com,www.coinex.org"
}'
Example Response
200 OK
{
  "code": 0,
  "data": {},
  "message": "OK"
}

# DELETE Delete Subscription Address

/{coin}/v1/webhook/address
params type required note
address string yes address to delete
Example Request
curl --location --request DELETE 'https://developers.viawallet.com/openapi/api/btc/v1/webhook/address/1EaSi5xycF5Ufpy2uSvCbjtSfnVPgeCiaj'
Example Response
200 OK
{
  "code": 0,
  "message": "OK",
  "data": {}
}

# DELETE Delete Subscription Address

/{coin}/v1/webhook/address
params type required note
address string yes address to delete
Example Request
curl --location --request DELETE 'https://developers.viawallet.com/openapi/api/btc/v1/webhook/address/1EaSi5xycF5Ufpy2uSvCbjtSfnVPgeCiaj'
Example Response
200 OK
{
  "code": 0,
  "message": "OK",
  "data": {}
}

# GET Review Subscription Address List

/{coin}/v1/webhook/addresses

To check monitoring address list, you need to specify the token name and page number

params type required note
page int no pages
limit int no number of returns

The return content format is as follows:

{
  "code": 0,
  "message": "OK",
  "data": [
    {
      "address": "1EaSi5xycF5Ufpy2uSvCbjtSfnVPgeCiaj",  // subscription address
      "coin": "BTC",                                    // token name
      "webhook_urls": [                                 // call url list
          "www.viawallet.com"
      ]
    }
  ]
    
}

Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/btc/v1/webhook/addresses'
Example Response
200 OK
{
  "code": 0,
  "message": "OK",
  "data": [
    {
      "address": "1EaSi5xycF5Ufpy2uSvCbjtSfnVPgeCiaj",
      "coin": "BTC",
      "webhook_urls": [
          "www.viawallet.com"
      ]
    }
  ]
    
}

# GET Review Subscription Address List

/{coin}/v1/webhook/addresses

To check monitoring address list, you need to specify the token name and page number

params type required note
page int no pages
limit int no number of returns

The return content format is as follows:

{
  "code": 0,
  "message": "OK",
  "data": [
    {
      "address": "1EaSi5xycF5Ufpy2uSvCbjtSfnVPgeCiaj",  // subscription address
      "coin": "BTC",                                    // token name
      "webhook_urls": [                                 // call url list
          "www.viawallet.com"
      ]
    }
  ]
    
}

Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/btc/v1/webhook/addresses'
Example Response
200 OK
{
  "code": 0,
  "message": "OK",
  "data": [
    {
      "address": "1EaSi5xycF5Ufpy2uSvCbjtSfnVPgeCiaj",
      "coin": "BTC",
      "webhook_urls": [
          "www.viawallet.com"
      ]
    }
  ]
    
}

# GET Review Webhook Historical Request Record

/{coin}/v1/webhook/logs

To check the call history of webhook, you need to specify the token name and page number.

params type required note
page int no pages
limit int no number of returns
{
    "date": 1616342401,                             // date
    "address":"1EaSi5xycF5Ufpy2uSvCbjtSfnVPgeCiaj", // address
    "coin":"BTC",                                   // token name
    "webhook_url":"www.viawallet.com",              // call url
    "status_code":0,                                // status code returned by code
    "error":"error"                                 // incorrect information
}

Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/btc/v1/webhook/logs'
Example Response
200 OK
{
  "code": 0,
  "message": "OK",
  "data": [
    { 
      "date": 1616342401, 
      "address":"1EaSi5xycF5Ufpy2uSvCbjtSfnVPgeCiaj",
      "coin":"BTC",
      "webhook_url":"www.viawallet.com", 
      "status_code":0, 
      "error":"", 
    }
  ]
}

# GET Review Webhook Historical Request Record

/{coin}/v1/webhook/logs

To check the call history of webhook, you need to specify the token name and page number.

params type required note
page int no pages
limit int no number of returns
{
    "date": 1616342401,                             // date
    "address":"1EaSi5xycF5Ufpy2uSvCbjtSfnVPgeCiaj", // address
    "coin":"BTC",                                   // token name
    "webhook_url":"www.viawallet.com",              // call url
    "status_code":0,                                // status code returned by code
    "error":"error"                                 // incorrect information
}

Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/btc/v1/webhook/logs'
Example Response
200 OK
{
  "code": 0,
  "message": "OK",
  "data": [
    { 
      "date": 1616342401, 
      "address":"1EaSi5xycF5Ufpy2uSvCbjtSfnVPgeCiaj",
      "coin":"BTC",
      "webhook_url":"www.viawallet.com", 
      "status_code":0, 
      "error":"", 
    }
  ]
}

# BTC and Other Similar Coins

# GET Review Public Chain Info

/{coin}/v1/chain/info

Through the abbreviation of the public chain, the basic information of the public chain can be obtained, including block height, number of transactions, circulation of native coins, network size, etc. The response content format is as follows:

{
    "symbol": "BTC",                                                            // token symbol
    "name": "Bitcoin",                                                          // token name
    "decimals": 8,                                                              // precision
    "block_time": 600000,                                                       // block time
    "sample_address": "bc1quvuarfksewfeuevuc6tn0kfyptgjvwsvrprk9d",             // sample address
    "height": 675870,                                                           // current block height
    "hash": "0000000000000000000cd537a29662f9003844d40cd7fbd6bd34e04b5adb354f", // current block hash
    "size": 70390928311,                                                        // chain size
    "tota_txs": 29045598,                                                       // total transactions
    "circulation":16923962                                                      // network circulation
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/btc/v1/chain/info'
Example Response
200 OK
{

  "code": 0,
  "message": "OK",
  "data": {
    "id": 0,
    "symbol": "BTC",
    "name": "Bitcoin",
    "decimals": 8,
    "block_time": 600000,
    "sample_address": "bc1quvuarfksewfeuevuc6tn0kfyptgjvwsvrprk9d",
    "height": 675870,
    "hash": "0000000000000000000cd537a29662f9003844d40cd7fbd6bd34e04b5adb354f",
    "size": 70390928311,
    "tota_txs": 29045598
  }
}

# BTC and Other Similar Coins

# GET Review Public Chain Info

/{coin}/v1/chain/info

Through the abbreviation of the public chain, the basic information of the public chain can be obtained, including block height, number of transactions, circulation of native coins, network size, etc. The response content format is as follows:

{
    "symbol": "BTC",                                                            // token symbol
    "name": "Bitcoin",                                                          // token name
    "decimals": 8,                                                              // precision
    "block_time": 600000,                                                       // block time
    "sample_address": "bc1quvuarfksewfeuevuc6tn0kfyptgjvwsvrprk9d",             // sample address
    "height": 675870,                                                           // current block height
    "hash": "0000000000000000000cd537a29662f9003844d40cd7fbd6bd34e04b5adb354f", // current block hash
    "size": 70390928311,                                                        // chain size
    "tota_txs": 29045598,                                                       // total transactions
    "circulation":16923962                                                      // network circulation
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/btc/v1/chain/info'
Example Response
200 OK
{

  "code": 0,
  "message": "OK",
  "data": {
    "id": 0,
    "symbol": "BTC",
    "name": "Bitcoin",
    "decimals": 8,
    "block_time": 600000,
    "sample_address": "bc1quvuarfksewfeuevuc6tn0kfyptgjvwsvrprk9d",
    "height": 675870,
    "hash": "0000000000000000000cd537a29662f9003844d40cd7fbd6bd34e04b5adb354f",
    "size": 70390928311,
    "tota_txs": 29045598
  }
}

# GET Review Block Info

/{coin}/v1/block

Review Block Info

params type required note
hashOrHeight string no block hash or block height

The return content format is as follows:

{
    "version": "549453824",                                                            // version, when it is null, the current field will not be returned
    "hash": "000000000000000000068bcb8f679a0783d3fb575ce34a968b14cbaf4744db59",        // current block hash
    "merkle_root": "5a4d3d153156039a027fc2390a29de4b052ca89bc01dbb1adaab4da9340404cc", // merkel root
    "confirmations": 1,                                                                // confirmation quantity
    "stripped_size": 555212,
    "size": 2327663,                                                                   // current block size
    "date": 1616467429,                                                                // timestamp
    "nonce": 2854784024, 
    "bits ": 386719599,
    "txs":[
        "ddb91aeb7e7d0f7a45da6bd5d31eac569f1104795d0d1d45801b212a9e4bb9b1",            // transaction hash
    ]
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/btc/v1/block?hashOrHeight=000000000000000000068bcb8f679a0783d3fb575ce34a968b14cbaf4744db59'

Example Response
200 OK
{
  "code": 0,
  "message": "OK",
  "data": {
    "version": "549453824",
    "hash": "000000000000000000068bcb8f679a0783d3fb575ce34a968b14cbaf4744db59", 
    "merkle_root": "5a4d3d153156039a027fc2390a29de4b052ca89bc01dbb1adaab4da9340404cc", 
    "confirmations": 1,
    "stripped_size": 555212, 
    "size": 2327663, 
    "date": 1616467429, 
    "nonce": 2854784024, 
    "bits ": 386719599, 
    "txs":[
        "ddb91aeb7e7d0f7a45da6bd5d31eac569f1104795d0d1d45801b212a9e4bb9b1", 
    ],   
  }
}

# GET Review Block Info

/{coin}/v1/block

Review Block Info

params type required note
hashOrHeight string no block hash or block height

The return content format is as follows:

{
    "version": "549453824",                                                            // version, when it is null, the current field will not be returned
    "hash": "000000000000000000068bcb8f679a0783d3fb575ce34a968b14cbaf4744db59",        // current block hash
    "merkle_root": "5a4d3d153156039a027fc2390a29de4b052ca89bc01dbb1adaab4da9340404cc", // merkel root
    "confirmations": 1,                                                                // confirmation quantity
    "stripped_size": 555212,
    "size": 2327663,                                                                   // current block size
    "date": 1616467429,                                                                // timestamp
    "nonce": 2854784024, 
    "bits ": 386719599,
    "txs":[
        "ddb91aeb7e7d0f7a45da6bd5d31eac569f1104795d0d1d45801b212a9e4bb9b1",            // transaction hash
    ]
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/btc/v1/block?hashOrHeight=000000000000000000068bcb8f679a0783d3fb575ce34a968b14cbaf4744db59'

Example Response
200 OK
{
  "code": 0,
  "message": "OK",
  "data": {
    "version": "549453824",
    "hash": "000000000000000000068bcb8f679a0783d3fb575ce34a968b14cbaf4744db59", 
    "merkle_root": "5a4d3d153156039a027fc2390a29de4b052ca89bc01dbb1adaab4da9340404cc", 
    "confirmations": 1,
    "stripped_size": 555212, 
    "size": 2327663, 
    "date": 1616467429, 
    "nonce": 2854784024, 
    "bits ": 386719599, 
    "txs":[
        "ddb91aeb7e7d0f7a45da6bd5d31eac569f1104795d0d1d45801b212a9e4bb9b1", 
    ],   
  }
}

# GET Acquire Address Info

/{coin}/v1/address/info

Acquire address information through the public chain acronym and address, including balance, balance ranking, number of transactions, number of transfers, amount of earnings, and details of a recent transaction.

params type required note
address string yes address to be review

The return content format is as follows:

{
    "address": "1H98Xu8Te6Lgu2Pj1uA6N5azLbjBP9Ncz2",                                // address
    "balance": 9973,                                                                // address balance needs to be divided by the precision of the token
    "balance_rank": 9758350,                                                        // balance ranking
    "total_txs": 27,                                                                // total transactions
    "total_tx_in": "15484598",                                                      // total transfers need to be divided by the precision of the token
    "total_tx_out": "15474625",                                                     // total withdrawals need to be divided by the precision of the token
    "latest_tx":{ 
          "id": "992b8c0b21b2df1fadee7977ef88cb311a307cd39d2ece3851d9a3e810167894", // txid
          "fee": "3008",                                                            // tx fee needs to be divided by the precision of the token
          "date": 1616367320,                                                       // timestamp
          "block": 675691,                                                          // block height
          "confirmation": 182,                                                      // confirmation quantity
          "status": "completed",                                                    // transaction status
          "inputs": [
            {
                "addresses": [
                    "1H98Xu8Te6Lgu2Pj1uA6N5azLbjBP9Ncz2"                            // input address
                ],
                "tx": "f18b8e446b0270e57c0a1def0c7dc84d40aee9beaedb9482204b7f870397cabb", // input tx hash
                "script_sig": "483045022100c5aab529b01b16a772f911f2b402173245d8b5ad0ac7db82b16f394567db387302205a4ee767d726037449710a7cb0d42ed3294570466c256f0221e7bc8f62d8d06601210264d52cd6e3019188ae97178384a6c6c15d9ca25c019ad1ccbd5e5f72304c48b3",
                "type": "pubkeyhash",
                "value": 40700,                                                     // amount
                "vfp": 0,                                                           // outputted index of a recent transaction
                "sequence": 4294967295
            },
            {
                "addresses": [
                   "1AQ1J6KJfM4AMjE33d2mZVyVnXoin1HpDM"
                 ],
                "tx": "fec9bcbdf5637b89424885dd219e51d50bde6ab73b508043e3037106f03cd0f8",
                "script_sig": "47304402203b2bea0ebfc925ae515cf48ac19bf750c0e9f313c3faf07b7efde8ae56d79838022020fe4eaa9c71ab962c13eab49107956e64dfc7ca07da6823d0b33f42b315dd4b0121032c791c9cecbe143c582f908396bf414775ce8c698ea5eb8d61ff1e8dfc652949",
                "type": "pubkeyhash",
                "value": 346572,
                "vfp": 0,
                "sequence": 4294967295
            }
          ],
            "outputs": [
                {
                    "addresses": [
                        "1H3YKH5EX6E7iMRoPZxuHwRPJnRSwGPnC"
                    ],
                    "script": "76a9140308c68df6134b45459f1384286b1137d32f8f1988ac",
                    "type": "pubkeyhash",
                    "value": 36132,
                    "n": 0,                                                         // output index
                    "next_position": 0,                                             // index of the spent transaction 
                    "ntx":"",                                                       // in which tx hash is spent
                },
                {
                    "addresses": [
                        "1KPW6tY3RovXNak2zAme4JCdcVunh6DLEL"
                    ],
                    "script": "76a914c9b3b53f60d100c362593bf86c89ac0ec8cdf5d688ac",
                    "type": "pubkeyhash",
                    "value": 348132,
                    "n": 1,
                    "next_position": 0,
                    "ntx":""
                }
            ],
            "memo": "",
            "metadata": null
        } 
    } // For a recent transaction, please see "Acquire block information based on block height or hash" to view the detailed field interpretation.
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/btc/v1/address/info?address=1H98Xu8Te6Lgu2Pj1uA6N5azLbjBP9Ncz2'
Example Response
200 OK
{
    "code": 0,
    "data": {
        "address": "1H98Xu8Te6Lgu2Pj1uA6N5azLbjBP9Ncz2",
        "balance": 9973,
        "balance_rank": 9758350,
        "total_txs": 27,
        "total_tx_in": "15484598",
        "total_tx_out": "15474625",
        "latest_tx": {
            "id": "992b8c0b21b2df1fadee7977ef88cb311a307cd39d2ece3851d9a3e810167894",
            "fee": "3008",
            "date": 1616367320,
            "block": 675691,
            "confirmation": 182,
            "status": "completed",
            "inputs": [
                {
                    "addresses": [
                        "1H98Xu8Te6Lgu2Pj1uA6N5azLbjBP9Ncz2"
                    ],
                    "tx": "f18b8e446b0270e57c0a1def0c7dc84d40aee9beaedb9482204b7f870397cabb",
                    "script_sig": "483045022100c5aab529b01b16a772f911f2b402173245d8b5ad0ac7db82b16f394567db387302205a4ee767d726037449710a7cb0d42ed3294570466c256f0221e7bc8f62d8d06601210264d52cd6e3019188ae97178384a6c6c15d9ca25c019ad1ccbd5e5f72304c48b3",
                    "type": "pubkeyhash",
                    "value": 40700,
                    "vfp": 0,
                    "sequence": 4294967295
                },
                {
                    "addresses": [
                        "1AQ1J6KJfM4AMjE33d2mZVyVnXoin1HpDM"
                    ],
                    "tx": "fec9bcbdf5637b89424885dd219e51d50bde6ab73b508043e3037106f03cd0f8",
                    "script_sig": "47304402203b2bea0ebfc925ae515cf48ac19bf750c0e9f313c3faf07b7efde8ae56d79838022020fe4eaa9c71ab962c13eab49107956e64dfc7ca07da6823d0b33f42b315dd4b0121032c791c9cecbe143c582f908396bf414775ce8c698ea5eb8d61ff1e8dfc652949",
                    "type": "pubkeyhash",
                    "value": 346572,
                    "vfp": 0,
                    "sequence": 4294967295
                }
            ],
            "outputs": [
                {
                    "addresses": [
                        "1H3YKH5EX6E7iMRoPZxuHwRPJnRSwGPnC"
                    ],
                    "script": "76a9140308c68df6134b45459f1384286b1137d32f8f1988ac",
                    "type": "pubkeyhash",
                    "value": 36132,
                    "n": 0,
                    "next_position": 0,
                },
                {
                    "addresses": [
                        "1KPW6tY3RovXNak2zAme4JCdcVunh6DLEL"
                    ],
                    "script": "76a914c9b3b53f60d100c362593bf86c89ac0ec8cdf5d688ac",
                    "type": "pubkeyhash",
                    "value": 348132,
                    "n": 1,
                    "next_position": 0,
                }
            ],
            "memo": "",
            "metadata": null
        }
    },
    "message": "OK"
}

# GET Acquire Address Info

/{coin}/v1/address/info

Acquire address information through the public chain acronym and address, including balance, balance ranking, number of transactions, number of transfers, amount of earnings, and details of a recent transaction.

params type required note
address string yes address to be review

The return content format is as follows:

{
    "address": "1H98Xu8Te6Lgu2Pj1uA6N5azLbjBP9Ncz2",                                // address
    "balance": 9973,                                                                // address balance needs to be divided by the precision of the token
    "balance_rank": 9758350,                                                        // balance ranking
    "total_txs": 27,                                                                // total transactions
    "total_tx_in": "15484598",                                                      // total transfers need to be divided by the precision of the token
    "total_tx_out": "15474625",                                                     // total withdrawals need to be divided by the precision of the token
    "latest_tx":{ 
          "id": "992b8c0b21b2df1fadee7977ef88cb311a307cd39d2ece3851d9a3e810167894", // txid
          "fee": "3008",                                                            // tx fee needs to be divided by the precision of the token
          "date": 1616367320,                                                       // timestamp
          "block": 675691,                                                          // block height
          "confirmation": 182,                                                      // confirmation quantity
          "status": "completed",                                                    // transaction status
          "inputs": [
            {
                "addresses": [
                    "1H98Xu8Te6Lgu2Pj1uA6N5azLbjBP9Ncz2"                            // input address
                ],
                "tx": "f18b8e446b0270e57c0a1def0c7dc84d40aee9beaedb9482204b7f870397cabb", // input tx hash
                "script_sig": "483045022100c5aab529b01b16a772f911f2b402173245d8b5ad0ac7db82b16f394567db387302205a4ee767d726037449710a7cb0d42ed3294570466c256f0221e7bc8f62d8d06601210264d52cd6e3019188ae97178384a6c6c15d9ca25c019ad1ccbd5e5f72304c48b3",
                "type": "pubkeyhash",
                "value": 40700,                                                     // amount
                "vfp": 0,                                                           // outputted index of a recent transaction
                "sequence": 4294967295
            },
            {
                "addresses": [
                   "1AQ1J6KJfM4AMjE33d2mZVyVnXoin1HpDM"
                 ],
                "tx": "fec9bcbdf5637b89424885dd219e51d50bde6ab73b508043e3037106f03cd0f8",
                "script_sig": "47304402203b2bea0ebfc925ae515cf48ac19bf750c0e9f313c3faf07b7efde8ae56d79838022020fe4eaa9c71ab962c13eab49107956e64dfc7ca07da6823d0b33f42b315dd4b0121032c791c9cecbe143c582f908396bf414775ce8c698ea5eb8d61ff1e8dfc652949",
                "type": "pubkeyhash",
                "value": 346572,
                "vfp": 0,
                "sequence": 4294967295
            }
          ],
            "outputs": [
                {
                    "addresses": [
                        "1H3YKH5EX6E7iMRoPZxuHwRPJnRSwGPnC"
                    ],
                    "script": "76a9140308c68df6134b45459f1384286b1137d32f8f1988ac",
                    "type": "pubkeyhash",
                    "value": 36132,
                    "n": 0,                                                         // output index
                    "next_position": 0,                                             // index of the spent transaction 
                    "ntx":"",                                                       // in which tx hash is spent
                },
                {
                    "addresses": [
                        "1KPW6tY3RovXNak2zAme4JCdcVunh6DLEL"
                    ],
                    "script": "76a914c9b3b53f60d100c362593bf86c89ac0ec8cdf5d688ac",
                    "type": "pubkeyhash",
                    "value": 348132,
                    "n": 1,
                    "next_position": 0,
                    "ntx":""
                }
            ],
            "memo": "",
            "metadata": null
        } 
    } // For a recent transaction, please see "Acquire block information based on block height or hash" to view the detailed field interpretation.
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/btc/v1/address/info?address=1H98Xu8Te6Lgu2Pj1uA6N5azLbjBP9Ncz2'
Example Response
200 OK
{
    "code": 0,
    "data": {
        "address": "1H98Xu8Te6Lgu2Pj1uA6N5azLbjBP9Ncz2",
        "balance": 9973,
        "balance_rank": 9758350,
        "total_txs": 27,
        "total_tx_in": "15484598",
        "total_tx_out": "15474625",
        "latest_tx": {
            "id": "992b8c0b21b2df1fadee7977ef88cb311a307cd39d2ece3851d9a3e810167894",
            "fee": "3008",
            "date": 1616367320,
            "block": 675691,
            "confirmation": 182,
            "status": "completed",
            "inputs": [
                {
                    "addresses": [
                        "1H98Xu8Te6Lgu2Pj1uA6N5azLbjBP9Ncz2"
                    ],
                    "tx": "f18b8e446b0270e57c0a1def0c7dc84d40aee9beaedb9482204b7f870397cabb",
                    "script_sig": "483045022100c5aab529b01b16a772f911f2b402173245d8b5ad0ac7db82b16f394567db387302205a4ee767d726037449710a7cb0d42ed3294570466c256f0221e7bc8f62d8d06601210264d52cd6e3019188ae97178384a6c6c15d9ca25c019ad1ccbd5e5f72304c48b3",
                    "type": "pubkeyhash",
                    "value": 40700,
                    "vfp": 0,
                    "sequence": 4294967295
                },
                {
                    "addresses": [
                        "1AQ1J6KJfM4AMjE33d2mZVyVnXoin1HpDM"
                    ],
                    "tx": "fec9bcbdf5637b89424885dd219e51d50bde6ab73b508043e3037106f03cd0f8",
                    "script_sig": "47304402203b2bea0ebfc925ae515cf48ac19bf750c0e9f313c3faf07b7efde8ae56d79838022020fe4eaa9c71ab962c13eab49107956e64dfc7ca07da6823d0b33f42b315dd4b0121032c791c9cecbe143c582f908396bf414775ce8c698ea5eb8d61ff1e8dfc652949",
                    "type": "pubkeyhash",
                    "value": 346572,
                    "vfp": 0,
                    "sequence": 4294967295
                }
            ],
            "outputs": [
                {
                    "addresses": [
                        "1H3YKH5EX6E7iMRoPZxuHwRPJnRSwGPnC"
                    ],
                    "script": "76a9140308c68df6134b45459f1384286b1137d32f8f1988ac",
                    "type": "pubkeyhash",
                    "value": 36132,
                    "n": 0,
                    "next_position": 0,
                },
                {
                    "addresses": [
                        "1KPW6tY3RovXNak2zAme4JCdcVunh6DLEL"
                    ],
                    "script": "76a914c9b3b53f60d100c362593bf86c89ac0ec8cdf5d688ac",
                    "type": "pubkeyhash",
                    "value": 348132,
                    "n": 1,
                    "next_position": 0,
                }
            ],
            "memo": "",
            "metadata": null
        }
    },
    "message": "OK"
}

# GET Acquire UTXO list of an address

/{coin}/v1/utxo

Acquire the unspent UTXO list of the address through the public chain acronym and address, which is usually used for offline transaction signature.

params type required note
address string yes address to be reviewed
nextkey string no query cursor

The return content format is as follows:

{
    "code": 0,
    "data": {
        "items": [
            {
                "address": "bc1qx9t2l3pyny2spqpqlye8svce70nppwtaxwdrp4",                        // address
                "tx_id": "1733c83851565e7e0a2af7db43708f76a628d9e9efc5928fe0e91c93f82cb785",    // tx hash
                "height": 677958,                                                               // block height
                "value": 649552102,                                                             // utxo balance
                "position": 0,                                                                  // utxo in the transaction
                "script": "00143156afc4249915008020f932783319f3e610b97d",                       // script value
                "date": 1617675530                                                              // date
            },
        ],
        "nextkey": ""
    },
    "message": "OK"
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/btc/v1/utxo?address=18Zcyxqna6h7Z7bRjhKvGpr8HSfieQWXqj'
Example Response
200 OK
{
    "code": 0,
    "data": {
        "items": [
            {
                "address": "bc1qx9t2l3pyny2spqpqlye8svce70nppwtaxwdrp4",
                "tx_id": "1733c83851565e7e0a2af7db43708f76a628d9e9efc5928fe0e91c93f82cb785",
                "height": 677958,
                "value": 649552102,
                "position": 0,
                "script": "00143156afc4249915008020f932783319f3e610b97d",
                "date": 1617675530
            },
            {
                "address": "bc1qx9t2l3pyny2spqpqlye8svce70nppwtaxwdrp4",
                "tx_id": "e31ff7aab365cd24c351da1d4d427e5389b65c8357325af02c56372fbc3ae582",
                "height": 677952,
                "value": 667970893,
                "position": 0,
                "script": "00143156afc4249915008020f932783319f3e610b97d",
                "date": 1617672757
            },
            {
                "address": "bc1qx9t2l3pyny2spqpqlye8svce70nppwtaxwdrp4",
                "tx_id": "772c7d70f49c0f481bdc27fe37f085093075b2b8f5e48933e2153e0fe3146400",
                "height": 677931,
                "value": 713368079,
                "position": 0,
                "script": "00143156afc4249915008020f932783319f3e610b97d",
                "date": 1617659888
            }
        ],
        "nextkey": "",
    },
    "message": "OK"
}

# GET Acquire UTXO list of an address

/{coin}/v1/utxo

Acquire the unspent UTXO list of the address through the public chain acronym and address, which is usually used for offline transaction signature.

params type required note
address string yes address to be reviewed
nextkey string no query cursor

The return content format is as follows:

{
    "code": 0,
    "data": {
        "items": [
            {
                "address": "bc1qx9t2l3pyny2spqpqlye8svce70nppwtaxwdrp4",                        // address
                "tx_id": "1733c83851565e7e0a2af7db43708f76a628d9e9efc5928fe0e91c93f82cb785",    // tx hash
                "height": 677958,                                                               // block height
                "value": 649552102,                                                             // utxo balance
                "position": 0,                                                                  // utxo in the transaction
                "script": "00143156afc4249915008020f932783319f3e610b97d",                       // script value
                "date": 1617675530                                                              // date
            },
        ],
        "nextkey": ""
    },
    "message": "OK"
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/btc/v1/utxo?address=18Zcyxqna6h7Z7bRjhKvGpr8HSfieQWXqj'
Example Response
200 OK
{
    "code": 0,
    "data": {
        "items": [
            {
                "address": "bc1qx9t2l3pyny2spqpqlye8svce70nppwtaxwdrp4",
                "tx_id": "1733c83851565e7e0a2af7db43708f76a628d9e9efc5928fe0e91c93f82cb785",
                "height": 677958,
                "value": 649552102,
                "position": 0,
                "script": "00143156afc4249915008020f932783319f3e610b97d",
                "date": 1617675530
            },
            {
                "address": "bc1qx9t2l3pyny2spqpqlye8svce70nppwtaxwdrp4",
                "tx_id": "e31ff7aab365cd24c351da1d4d427e5389b65c8357325af02c56372fbc3ae582",
                "height": 677952,
                "value": 667970893,
                "position": 0,
                "script": "00143156afc4249915008020f932783319f3e610b97d",
                "date": 1617672757
            },
            {
                "address": "bc1qx9t2l3pyny2spqpqlye8svce70nppwtaxwdrp4",
                "tx_id": "772c7d70f49c0f481bdc27fe37f085093075b2b8f5e48933e2153e0fe3146400",
                "height": 677931,
                "value": 713368079,
                "position": 0,
                "script": "00143156afc4249915008020f932783319f3e610b97d",
                "date": 1617659888
            }
        ],
        "nextkey": "",
    },
    "message": "OK"
}

# GET Acquire Address Transaction List

/{coin}/v1/address/txs

Acquire the transaction history of an address through the public chain acronym and address.

params type required note
address string yes address to be reviewed
nextkey string no query cursor

The return content format is as follows:

{
    "code": 0,
    "data": {
        "items": [
            {
                "id": "c7841cb796c64027391038673de23d2b242fd2108c1e7092b9207cf6ef46ecb8",  // tx hash
                "fee": "-313828",                                                          // fee
                "date": 1617109308,                                                        // date 
                "block": 676997,                                                           // block height
                "confirmation": 966,                                                       // confirmations
                "status": "completed",                                                     // transaction status
                "inputs": [                                                                // transaction inputs
                    {
                        "addresses": [                                                     // address list
                            "13vDqiRpJ7h9oSri85e6wonvgtKYbVXiHp"
                        ],
                        "tx": "5d3c394304a52aeb7f0a055e3cbabce6462962db3009f2ca84da5247bc4bf710", // inputted tx hash
                        "script_sig": "483045022100ae07c018a81ce86cd0324ff13cd5bbee4064180b818ec491d9aa6c63ccc84ae702202bb4040c6c94d6509a0cd56fe3625968dccbd3308d1cd2d0376f9f145f3f033b01210360c5c6cd2c7f93b68c834ca38ba27f9a2f6f4d74153bf0bc007cd17c8bda1cbf",                                                       // signature
                        "type": "pubkeyhash",
                        "value": 347238,                                                    // value
                        "vfp": 1,
                        "sequence": 4294967295
                    },
                    {
                        "tx": "83e6deea63ea60d2265a0fc3b1e41fa2b5d78e16543c6efb19694721786c01e8",
                        "script_sig": "473044022078b9464543b0e028e897aab1212cf8c9fe3b1fdbef7d603d7511e97a4f4c05820220224035cbadbd31b565b61985c50e25fd3eff678fdc0b147155f2d07de6b5e8cc012102c625fbd4a74117a739ee5489ccd98e3e824f8406adaec3274bed4699cf53f675",
                        "value": 0,
                        "vfp": 0,
                        "sequence": 4294967295
                    }
                ],
                "outputs": [                                                                // transaction outputs
                    {
                        "addresses": [
                            "1AYnQmwWYuomJaJGNkUKkaGdi9Hdfjtkct"
                        ],
                        "script": "76a91468bbeee32eab032e8865d2ec07ff479a7ad8304288ac",
                        "type": "pubkeyhash",
                        "next_tx_id": "8f4d66d927b55cc90c6a7641bc85bf80aed3bd694b6f1b04ac09671cd0389dda",
                        "value": 307895,
                        "n": 0,
                        "next_position": 0
                    },
                    {
                        "addresses": [
                            "12JaDBoKxyz5UkzLj4hJqFkqJczY1FjZqs"
                        ],
                        "script": "76a9140e4aeb66a77a89e013d63e852232998031c8910e88ac",
                        "type": "pubkeyhash",
                        "next_tx_id": "9e7cff97dfdeb08c158bf8e7fb22288562bf21bec6e61f20fa035893f4b2fb10",
                        "value": 353171,
                        "n": 1,
                        "next_position": 3
                    }
                ],
                "memo": "",
                "metadata": null
            },
        ],
        "nextkey": "B1jgkPtsA1FQR21eYU",
        "page": 0
    },
    "message": "OK"
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/btc/v1/txs?address=1DfDKUMzSxJD8dontsxTvXVUUBZrQ24ZfA'

Example Response
200 OK

{
    "code": 0,
    "data": {
        "items": [
            {
                "id": "c7841cb796c64027391038673de23d2b242fd2108c1e7092b9207cf6ef46ecb8",
                "fee": "-313828",
                "date": 1617109308,
                "block": 676997,
                "confirmation": 966,
                "status": "completed",
                "inputs": [
                    {
                        "addresses": [
                            "13vDqiRpJ7h9oSri85e6wonvgtKYbVXiHp"
                        ],
                        "tx": "5d3c394304a52aeb7f0a055e3cbabce6462962db3009f2ca84da5247bc4bf710",
                        "script_sig": "483045022100ae07c018a81ce86cd0324ff13cd5bbee4064180b818ec491d9aa6c63ccc84ae702202bb4040c6c94d6509a0cd56fe3625968dccbd3308d1cd2d0376f9f145f3f033b01210360c5c6cd2c7f93b68c834ca38ba27f9a2f6f4d74153bf0bc007cd17c8bda1cbf",
                        "type": "pubkeyhash",
                        "value": 347238,
                        "vfp": 1,
                        "sequence": 4294967295
                    },
                    {
                        "tx": "83e6deea63ea60d2265a0fc3b1e41fa2b5d78e16543c6efb19694721786c01e8",
                        "script_sig": "473044022078b9464543b0e028e897aab1212cf8c9fe3b1fdbef7d603d7511e97a4f4c05820220224035cbadbd31b565b61985c50e25fd3eff678fdc0b147155f2d07de6b5e8cc012102c625fbd4a74117a739ee5489ccd98e3e824f8406adaec3274bed4699cf53f675",
                        "value": 0,
                        "vfp": 0,
                        "sequence": 4294967295
                    }
                ],
                "outputs": [
                    {
                        "addresses": [
                            "1AYnQmwWYuomJaJGNkUKkaGdi9Hdfjtkct"
                        ],
                        "script": "76a91468bbeee32eab032e8865d2ec07ff479a7ad8304288ac",
                        "type": "pubkeyhash",
                        "next_tx_id": "8f4d66d927b55cc90c6a7641bc85bf80aed3bd694b6f1b04ac09671cd0389dda",
                        "value": 307895,
                        "n": 0,
                        "next_position": 0
                    },
                    {
                        "addresses": [
                            "12JaDBoKxyz5UkzLj4hJqFkqJczY1FjZqs"
                        ],
                        "script": "76a9140e4aeb66a77a89e013d63e852232998031c8910e88ac",
                        "type": "pubkeyhash",
                        "next_tx_id": "9e7cff97dfdeb08c158bf8e7fb22288562bf21bec6e61f20fa035893f4b2fb10",
                        "value": 353171,
                        "n": 1,
                        "next_position": 3
                    }
                ],
                "memo": "",
                "metadata": null
            },
        ],
        "nextkey": "B1jgkPtsA1FQR21eYU",
    },
    "message": "OK"
}

# GET Acquire Address Transaction List

/{coin}/v1/address/txs

Acquire the transaction history of an address through the public chain acronym and address.

params type required note
address string yes address to be reviewed
nextkey string no query cursor

The return content format is as follows:

{
    "code": 0,
    "data": {
        "items": [
            {
                "id": "c7841cb796c64027391038673de23d2b242fd2108c1e7092b9207cf6ef46ecb8",  // tx hash
                "fee": "-313828",                                                          // fee
                "date": 1617109308,                                                        // date 
                "block": 676997,                                                           // block height
                "confirmation": 966,                                                       // confirmations
                "status": "completed",                                                     // transaction status
                "inputs": [                                                                // transaction inputs
                    {
                        "addresses": [                                                     // address list
                            "13vDqiRpJ7h9oSri85e6wonvgtKYbVXiHp"
                        ],
                        "tx": "5d3c394304a52aeb7f0a055e3cbabce6462962db3009f2ca84da5247bc4bf710", // inputted tx hash
                        "script_sig": "483045022100ae07c018a81ce86cd0324ff13cd5bbee4064180b818ec491d9aa6c63ccc84ae702202bb4040c6c94d6509a0cd56fe3625968dccbd3308d1cd2d0376f9f145f3f033b01210360c5c6cd2c7f93b68c834ca38ba27f9a2f6f4d74153bf0bc007cd17c8bda1cbf",                                                       // signature
                        "type": "pubkeyhash",
                        "value": 347238,                                                    // value
                        "vfp": 1,
                        "sequence": 4294967295
                    },
                    {
                        "tx": "83e6deea63ea60d2265a0fc3b1e41fa2b5d78e16543c6efb19694721786c01e8",
                        "script_sig": "473044022078b9464543b0e028e897aab1212cf8c9fe3b1fdbef7d603d7511e97a4f4c05820220224035cbadbd31b565b61985c50e25fd3eff678fdc0b147155f2d07de6b5e8cc012102c625fbd4a74117a739ee5489ccd98e3e824f8406adaec3274bed4699cf53f675",
                        "value": 0,
                        "vfp": 0,
                        "sequence": 4294967295
                    }
                ],
                "outputs": [                                                                // transaction outputs
                    {
                        "addresses": [
                            "1AYnQmwWYuomJaJGNkUKkaGdi9Hdfjtkct"
                        ],
                        "script": "76a91468bbeee32eab032e8865d2ec07ff479a7ad8304288ac",
                        "type": "pubkeyhash",
                        "next_tx_id": "8f4d66d927b55cc90c6a7641bc85bf80aed3bd694b6f1b04ac09671cd0389dda",
                        "value": 307895,
                        "n": 0,
                        "next_position": 0
                    },
                    {
                        "addresses": [
                            "12JaDBoKxyz5UkzLj4hJqFkqJczY1FjZqs"
                        ],
                        "script": "76a9140e4aeb66a77a89e013d63e852232998031c8910e88ac",
                        "type": "pubkeyhash",
                        "next_tx_id": "9e7cff97dfdeb08c158bf8e7fb22288562bf21bec6e61f20fa035893f4b2fb10",
                        "value": 353171,
                        "n": 1,
                        "next_position": 3
                    }
                ],
                "memo": "",
                "metadata": null
            },
        ],
        "nextkey": "B1jgkPtsA1FQR21eYU",
        "page": 0
    },
    "message": "OK"
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/btc/v1/txs?address=1DfDKUMzSxJD8dontsxTvXVUUBZrQ24ZfA'

Example Response
200 OK

{
    "code": 0,
    "data": {
        "items": [
            {
                "id": "c7841cb796c64027391038673de23d2b242fd2108c1e7092b9207cf6ef46ecb8",
                "fee": "-313828",
                "date": 1617109308,
                "block": 676997,
                "confirmation": 966,
                "status": "completed",
                "inputs": [
                    {
                        "addresses": [
                            "13vDqiRpJ7h9oSri85e6wonvgtKYbVXiHp"
                        ],
                        "tx": "5d3c394304a52aeb7f0a055e3cbabce6462962db3009f2ca84da5247bc4bf710",
                        "script_sig": "483045022100ae07c018a81ce86cd0324ff13cd5bbee4064180b818ec491d9aa6c63ccc84ae702202bb4040c6c94d6509a0cd56fe3625968dccbd3308d1cd2d0376f9f145f3f033b01210360c5c6cd2c7f93b68c834ca38ba27f9a2f6f4d74153bf0bc007cd17c8bda1cbf",
                        "type": "pubkeyhash",
                        "value": 347238,
                        "vfp": 1,
                        "sequence": 4294967295
                    },
                    {
                        "tx": "83e6deea63ea60d2265a0fc3b1e41fa2b5d78e16543c6efb19694721786c01e8",
                        "script_sig": "473044022078b9464543b0e028e897aab1212cf8c9fe3b1fdbef7d603d7511e97a4f4c05820220224035cbadbd31b565b61985c50e25fd3eff678fdc0b147155f2d07de6b5e8cc012102c625fbd4a74117a739ee5489ccd98e3e824f8406adaec3274bed4699cf53f675",
                        "value": 0,
                        "vfp": 0,
                        "sequence": 4294967295
                    }
                ],
                "outputs": [
                    {
                        "addresses": [
                            "1AYnQmwWYuomJaJGNkUKkaGdi9Hdfjtkct"
                        ],
                        "script": "76a91468bbeee32eab032e8865d2ec07ff479a7ad8304288ac",
                        "type": "pubkeyhash",
                        "next_tx_id": "8f4d66d927b55cc90c6a7641bc85bf80aed3bd694b6f1b04ac09671cd0389dda",
                        "value": 307895,
                        "n": 0,
                        "next_position": 0
                    },
                    {
                        "addresses": [
                            "12JaDBoKxyz5UkzLj4hJqFkqJczY1FjZqs"
                        ],
                        "script": "76a9140e4aeb66a77a89e013d63e852232998031c8910e88ac",
                        "type": "pubkeyhash",
                        "next_tx_id": "9e7cff97dfdeb08c158bf8e7fb22288562bf21bec6e61f20fa035893f4b2fb10",
                        "value": 353171,
                        "n": 1,
                        "next_position": 3
                    }
                ],
                "memo": "",
                "metadata": null
            },
        ],
        "nextkey": "B1jgkPtsA1FQR21eYU",
    },
    "message": "OK"
}

# GET Address Pending Transaction List

/{coin}/v1/unconfirmed_txs

Obtain the pending transaction list of the address through the abbreviation of the public chain.

params type required note
address string yes address to be review

The return content format is as follows:

{
    "code":0,
    "message":"OK",
    "data": [
        {
            "id": "fce47bbec9029369b511a1474f92c22f3c1687e8df763f1798ab9fdcf519b278",         // tx has
            "fee": "2270",                                                                    // fee
            "date": 1616479878,                                                               // date
            "block": 0,                                                                     
            "confirmation": 0,
            "status": "pending",                                                              // transaction status
            "inputs": [                                                                       // transaction inputs
                {
                    "addresses": [                                  
                        "1DTt8RuAbebwuSTpYPAwixShvT6oeck7We"
                    ],
                    "tx": "06208f276801896b42acb1567de9466ebc1ed33650120870d0b04462029d1197", // inputted tx hash
                    "script_sig": "483045022100b08f642ad75694212911503e51ae95b0e912e4cbb0f5d59ea6bcaecb0b425f520220139bdd50a9f4343faf96b84658a86c32958ab8414ef76ae70a0d38159dbe27a0012103e73051c6b5293f220d033758adfa238d3328e67b79ca5c382060471d8d3b7043",                                                     // signature
                    "type": "pubkeyhash",
                    "value": 983021,                                                          // value
                    "vfp": 74,
                    "sequence": 4294967295
                }
            ],
            "outputs": [                                                                      // transaction outputs
                {
                    "addresses": [
                        "3DNtQzBExZgvo4w2iVuZNPsoQ5PXi4dfuy"
                    ],
                    "script": "a9148033c0de297577714c4883ba6f556ffe8b87c43d87",
                    "type": "scripthash",
                    "value": 14984,
                    "n": 0,
                    "next_position": 0,
                },
                {
                    "addresses": [
                        "1NQz4aMBujoua7t7yDcfcWXHFKNBxesxks"
                    ],
                    "script": "76a914eae3d75b47e6d1043daebe2d3b04bddb67fcb68f88ac",
                    "type": "pubkeyhash",
                    "value": 965767,
                    "n": 1,
                    "next_position": 0,
                }
            ],
            "memo": "",
            "metadata": null
        }
    ]
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/btc/v1/unconfirmed_txs/bc1qrg6paunl8vwcddejwqzeddfmckycytq2uqxx20'

Example Response
200 OK
{
    "code":0,
    "message":"OK",
    "data": [
        {
            "id": "fce47bbec9029369b511a1474f92c22f3c1687e8df763f1798ab9fdcf519b278",
            "fee": "2270",
            "date": 1616479878,
            "block": 0,
            "confirmation": 0,
            "status": "pending",
            "inputs": [
                {
                    "addresses": [
                        "1DTt8RuAbebwuSTpYPAwixShvT6oeck7We"
                    ],
                    "tx": "06208f276801896b42acb1567de9466ebc1ed33650120870d0b04462029d1197",
                    "script_sig": "483045022100b08f642ad75694212911503e51ae95b0e912e4cbb0f5d59ea6bcaecb0b425f520220139bdd50a9f4343faf96b84658a86c32958ab8414ef76ae70a0d38159dbe27a0012103e73051c6b5293f220d033758adfa238d3328e67b79ca5c382060471d8d3b7043",
                    "type": "pubkeyhash",
                    "value": 983021,
                    "vfp": 74,
                    "sequence": 4294967295
                }
            ],
            "outputs": [
                {
                    "addresses": [
                        "3DNtQzBExZgvo4w2iVuZNPsoQ5PXi4dfuy"
                    ],
                    "script": "a9148033c0de297577714c4883ba6f556ffe8b87c43d87",
                    "type": "scripthash",
                    "value": 14984,
                    "n": 0,
                    "next_position": 0,
                },
                {
                    "addresses": [
                        "1NQz4aMBujoua7t7yDcfcWXHFKNBxesxks"
                    ],
                    "script": "76a914eae3d75b47e6d1043daebe2d3b04bddb67fcb68f88ac",
                    "type": "pubkeyhash",
                    "value": 965767,
                    "n": 1,
                    "next_position": 0,
                }
            ],
            "memo": "",
            "metadata": null
        }
    ]
}

# GET Address Pending Transaction List

/{coin}/v1/unconfirmed_txs

Obtain the pending transaction list of the address through the abbreviation of the public chain.

params type required note
address string yes address to be review

The return content format is as follows:

{
    "code":0,
    "message":"OK",
    "data": [
        {
            "id": "fce47bbec9029369b511a1474f92c22f3c1687e8df763f1798ab9fdcf519b278",         // tx has
            "fee": "2270",                                                                    // fee
            "date": 1616479878,                                                               // date
            "block": 0,                                                                     
            "confirmation": 0,
            "status": "pending",                                                              // transaction status
            "inputs": [                                                                       // transaction inputs
                {
                    "addresses": [                                  
                        "1DTt8RuAbebwuSTpYPAwixShvT6oeck7We"
                    ],
                    "tx": "06208f276801896b42acb1567de9466ebc1ed33650120870d0b04462029d1197", // inputted tx hash
                    "script_sig": "483045022100b08f642ad75694212911503e51ae95b0e912e4cbb0f5d59ea6bcaecb0b425f520220139bdd50a9f4343faf96b84658a86c32958ab8414ef76ae70a0d38159dbe27a0012103e73051c6b5293f220d033758adfa238d3328e67b79ca5c382060471d8d3b7043",                                                     // signature
                    "type": "pubkeyhash",
                    "value": 983021,                                                          // value
                    "vfp": 74,
                    "sequence": 4294967295
                }
            ],
            "outputs": [                                                                      // transaction outputs
                {
                    "addresses": [
                        "3DNtQzBExZgvo4w2iVuZNPsoQ5PXi4dfuy"
                    ],
                    "script": "a9148033c0de297577714c4883ba6f556ffe8b87c43d87",
                    "type": "scripthash",
                    "value": 14984,
                    "n": 0,
                    "next_position": 0,
                },
                {
                    "addresses": [
                        "1NQz4aMBujoua7t7yDcfcWXHFKNBxesxks"
                    ],
                    "script": "76a914eae3d75b47e6d1043daebe2d3b04bddb67fcb68f88ac",
                    "type": "pubkeyhash",
                    "value": 965767,
                    "n": 1,
                    "next_position": 0,
                }
            ],
            "memo": "",
            "metadata": null
        }
    ]
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/btc/v1/unconfirmed_txs/bc1qrg6paunl8vwcddejwqzeddfmckycytq2uqxx20'

Example Response
200 OK
{
    "code":0,
    "message":"OK",
    "data": [
        {
            "id": "fce47bbec9029369b511a1474f92c22f3c1687e8df763f1798ab9fdcf519b278",
            "fee": "2270",
            "date": 1616479878,
            "block": 0,
            "confirmation": 0,
            "status": "pending",
            "inputs": [
                {
                    "addresses": [
                        "1DTt8RuAbebwuSTpYPAwixShvT6oeck7We"
                    ],
                    "tx": "06208f276801896b42acb1567de9466ebc1ed33650120870d0b04462029d1197",
                    "script_sig": "483045022100b08f642ad75694212911503e51ae95b0e912e4cbb0f5d59ea6bcaecb0b425f520220139bdd50a9f4343faf96b84658a86c32958ab8414ef76ae70a0d38159dbe27a0012103e73051c6b5293f220d033758adfa238d3328e67b79ca5c382060471d8d3b7043",
                    "type": "pubkeyhash",
                    "value": 983021,
                    "vfp": 74,
                    "sequence": 4294967295
                }
            ],
            "outputs": [
                {
                    "addresses": [
                        "3DNtQzBExZgvo4w2iVuZNPsoQ5PXi4dfuy"
                    ],
                    "script": "a9148033c0de297577714c4883ba6f556ffe8b87c43d87",
                    "type": "scripthash",
                    "value": 14984,
                    "n": 0,
                    "next_position": 0,
                },
                {
                    "addresses": [
                        "1NQz4aMBujoua7t7yDcfcWXHFKNBxesxks"
                    ],
                    "script": "76a914eae3d75b47e6d1043daebe2d3b04bddb67fcb68f88ac",
                    "type": "pubkeyhash",
                    "value": 965767,
                    "n": 1,
                    "next_position": 0,
                }
            ],
            "memo": "",
            "metadata": null
        }
    ]
}

# GET Acquire Transaction Details

/{coin}/v1/tx

Acquire the transaction details through the abbreviation of the public chain and tx hash. For ckb, the tx details only return the main chain asset transfer and payment information, and will not return the token transfer or contract call information.

params type required note
tx_id string yes the hash of transaction to be review

The return content format is as follows:

{
    "code": 0,
    "data": {
        "id": "c7841cb796c64027391038673de23d2b242fd2108c1e7092b9207cf6ef46ecb8",  // tx hash
        "fee": "-313828",                                                          // fee
        "date": 1617109308,                                                        // date 
        "block": 676997,                                                           // block height
        "confirmation": 966,                                                       // confirmations
        "status": "completed",                                                     // transaction status
        "inputs": [                                                                // transaction inputs
            {
                 "addresses": [                                                     // address list
                    "13vDqiRpJ7h9oSri85e6wonvgtKYbVXiHp"
                ],
                "tx": "5d3c394304a52aeb7f0a055e3cbabce6462962db3009f2ca84da5247bc4bf710", // inputted tx hash
                "script_sig": "483045022100ae07c018a81ce86cd0324ff13cd5bbee4064180b818ec491d9aa6c63ccc84ae702202bb4040c6c94d6509a0cd56fe3625968dccbd3308d1cd2d0376f9f145f3f033b01210360c5c6cd2c7f93b68c834ca38ba27f9a2f6f4d74153bf0bc007cd17c8bda1cbf",                                                       // signature
                "type": "pubkeyhash",
                "value": 347238,                                                    // value
                "vfp": 1,
                "sequence": 4294967295
            },
            {
                "tx": "83e6deea63ea60d2265a0fc3b1e41fa2b5d78e16543c6efb19694721786c01e8",
                 "script_sig": "473044022078b9464543b0e028e897aab1212cf8c9fe3b1fdbef7d603d7511e97a4f4c05820220224035cbadbd31b565b61985c50e25fd3eff678fdc0b147155f2d07de6b5e8cc012102c625fbd4a74117a739ee5489ccd98e3e824f8406adaec3274bed4699cf53f675",
                "value": 0,
                "vfp": 0,
                "sequence": 4294967295
            }
        ],
        "outputs": [                                                                // transaction outputs
            {
                "addresses": [
                    "1AYnQmwWYuomJaJGNkUKkaGdi9Hdfjtkct"
                ],
                "script": "76a91468bbeee32eab032e8865d2ec07ff479a7ad8304288ac",
                "type": "pubkeyhash",
                "next_tx_id": "8f4d66d927b55cc90c6a7641bc85bf80aed3bd694b6f1b04ac09671cd0389dda",
                "value": 307895,
                "n": 0,
                "next_position": 0
            },
            {
                "addresses": [
                    "12JaDBoKxyz5UkzLj4hJqFkqJczY1FjZqs"
                ],
                "script": "76a9140e4aeb66a77a89e013d63e852232998031c8910e88ac",
                "type": "pubkeyhash",
                "next_tx_id": "9e7cff97dfdeb08c158bf8e7fb22288562bf21bec6e61f20fa035893f4b2fb10",
                "value": 353171,
                "n": 1,
                "next_position": 3
            }
        ],
        "memo": "",
        "metadata": null
    },
    "message": "OK"
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/btc/v1/tx?tx_id=5d3c394304a52aeb7f0a055e3cbabce6462962db3009f2ca84da5247bc4bf710'

Example Response
200 OK
{
    "code":0,
    "message":"OK",
    "data": {
        "id": "5d3c394304a52aeb7f0a055e3cbabce6462962db3009f2ca84da5247bc4bf710",
        "fee": "17706",
        "date": 1616171114,
        "block": 675336,
        "confirmation": 554,
        "status": "completed",
        "inputs": [
            {
                "addresses": [
                    "178monFk9M49PyVi2PmP1Whce8VyvdRZ9T"
                ],
                "tx": "1e67b7c8368edc33c2db3d93716054259eb019fd0cacf4728235e52e8de326ef",
                "script_sig": "4830450221009faabcc6f33a24b42a4181ea73f5a20044a0d339ee5bd928d06eb7b8f1b1eca80220321a8823d91503af497656fbdf87dde5d4781b8ddf545135527aa373d2f3dff70121025ff937e5b23ba3102662990da6dff055514d19f59aba93aaa54aed5eb9674a21",
                "type": "pubkeyhash",
                "value": 379913,
                "vfp": 1,
                "sequence": 4294967295
            }
        ],
        "outputs": [
            {
                "addresses": [
                    "1H98Xu8Te6Lgu2Pj1uA6N5azLbjBP9Ncz2"
                ],
                "script": "76a914b10ba0d4d038c11c50e704ab145302f6c984afe688ac",
                "type": "pubkeyhash",
                "next_tx_id": "aef8039dbead733bf5f58c9ea37de771157dab24f76348cb4da675938c640506",
                "value": 14969,
                "n": 0,
                "next_position": 0,
            },
            {
                "addresses": [
                    "13vDqiRpJ7h9oSri85e6wonvgtKYbVXiHp"
                ],
                "script": "76a914200104085600bedcaad07ef371fdc1620f1c0a8088ac",
                "type": "pubkeyhash",
                "value": 347238,
                "n": 1,
                "next_position": 0,
            }
        ],
        "memo": "",
        "metadata": null
    }
}

# GET Acquire Transaction Details

/{coin}/v1/tx

Acquire the transaction details through the abbreviation of the public chain and tx hash. For ckb, the tx details only return the main chain asset transfer and payment information, and will not return the token transfer or contract call information.

params type required note
tx_id string yes the hash of transaction to be review

The return content format is as follows:

{
    "code": 0,
    "data": {
        "id": "c7841cb796c64027391038673de23d2b242fd2108c1e7092b9207cf6ef46ecb8",  // tx hash
        "fee": "-313828",                                                          // fee
        "date": 1617109308,                                                        // date 
        "block": 676997,                                                           // block height
        "confirmation": 966,                                                       // confirmations
        "status": "completed",                                                     // transaction status
        "inputs": [                                                                // transaction inputs
            {
                 "addresses": [                                                     // address list
                    "13vDqiRpJ7h9oSri85e6wonvgtKYbVXiHp"
                ],
                "tx": "5d3c394304a52aeb7f0a055e3cbabce6462962db3009f2ca84da5247bc4bf710", // inputted tx hash
                "script_sig": "483045022100ae07c018a81ce86cd0324ff13cd5bbee4064180b818ec491d9aa6c63ccc84ae702202bb4040c6c94d6509a0cd56fe3625968dccbd3308d1cd2d0376f9f145f3f033b01210360c5c6cd2c7f93b68c834ca38ba27f9a2f6f4d74153bf0bc007cd17c8bda1cbf",                                                       // signature
                "type": "pubkeyhash",
                "value": 347238,                                                    // value
                "vfp": 1,
                "sequence": 4294967295
            },
            {
                "tx": "83e6deea63ea60d2265a0fc3b1e41fa2b5d78e16543c6efb19694721786c01e8",
                 "script_sig": "473044022078b9464543b0e028e897aab1212cf8c9fe3b1fdbef7d603d7511e97a4f4c05820220224035cbadbd31b565b61985c50e25fd3eff678fdc0b147155f2d07de6b5e8cc012102c625fbd4a74117a739ee5489ccd98e3e824f8406adaec3274bed4699cf53f675",
                "value": 0,
                "vfp": 0,
                "sequence": 4294967295
            }
        ],
        "outputs": [                                                                // transaction outputs
            {
                "addresses": [
                    "1AYnQmwWYuomJaJGNkUKkaGdi9Hdfjtkct"
                ],
                "script": "76a91468bbeee32eab032e8865d2ec07ff479a7ad8304288ac",
                "type": "pubkeyhash",
                "next_tx_id": "8f4d66d927b55cc90c6a7641bc85bf80aed3bd694b6f1b04ac09671cd0389dda",
                "value": 307895,
                "n": 0,
                "next_position": 0
            },
            {
                "addresses": [
                    "12JaDBoKxyz5UkzLj4hJqFkqJczY1FjZqs"
                ],
                "script": "76a9140e4aeb66a77a89e013d63e852232998031c8910e88ac",
                "type": "pubkeyhash",
                "next_tx_id": "9e7cff97dfdeb08c158bf8e7fb22288562bf21bec6e61f20fa035893f4b2fb10",
                "value": 353171,
                "n": 1,
                "next_position": 3
            }
        ],
        "memo": "",
        "metadata": null
    },
    "message": "OK"
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/btc/v1/tx?tx_id=5d3c394304a52aeb7f0a055e3cbabce6462962db3009f2ca84da5247bc4bf710'

Example Response
200 OK
{
    "code":0,
    "message":"OK",
    "data": {
        "id": "5d3c394304a52aeb7f0a055e3cbabce6462962db3009f2ca84da5247bc4bf710",
        "fee": "17706",
        "date": 1616171114,
        "block": 675336,
        "confirmation": 554,
        "status": "completed",
        "inputs": [
            {
                "addresses": [
                    "178monFk9M49PyVi2PmP1Whce8VyvdRZ9T"
                ],
                "tx": "1e67b7c8368edc33c2db3d93716054259eb019fd0cacf4728235e52e8de326ef",
                "script_sig": "4830450221009faabcc6f33a24b42a4181ea73f5a20044a0d339ee5bd928d06eb7b8f1b1eca80220321a8823d91503af497656fbdf87dde5d4781b8ddf545135527aa373d2f3dff70121025ff937e5b23ba3102662990da6dff055514d19f59aba93aaa54aed5eb9674a21",
                "type": "pubkeyhash",
                "value": 379913,
                "vfp": 1,
                "sequence": 4294967295
            }
        ],
        "outputs": [
            {
                "addresses": [
                    "1H98Xu8Te6Lgu2Pj1uA6N5azLbjBP9Ncz2"
                ],
                "script": "76a914b10ba0d4d038c11c50e704ab145302f6c984afe688ac",
                "type": "pubkeyhash",
                "next_tx_id": "aef8039dbead733bf5f58c9ea37de771157dab24f76348cb4da675938c640506",
                "value": 14969,
                "n": 0,
                "next_position": 0,
            },
            {
                "addresses": [
                    "13vDqiRpJ7h9oSri85e6wonvgtKYbVXiHp"
                ],
                "script": "76a914200104085600bedcaad07ef371fdc1620f1c0a8088ac",
                "type": "pubkeyhash",
                "value": 347238,
                "n": 1,
                "next_position": 0,
            }
        ],
        "memo": "",
        "metadata": null
    }
}

# GET Acquire the Number of Confirmations

/{coin}/v1/tx/confirmation

Acquire the number of confirmations through the abbreviation of the public chain and tx hash.

params type required note
tx_id string yes the translation hash to be review

The return content format is as follows:

{
    "code":0,
    "message":"OK",
    "data":{
        "confirmation": 554,                                                         // confirmations
        "platform": "BTC",                                                           // token name
        "tx_id": "5d3c394304a52aeb7f0a055e3cbabce6462962db3009f2ca84da5247bc4bf710"  // tx hash
    }
}

Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/btc/v1/tx/confirmation?tx_id=5d3c394304a52aeb7f0a055e3cbabce6462962db3009f2ca84da5247bc4bf710
'
Example Response
200 OK
{
    "code":0,
    "message":"OK",
    "data":{
        "confirmation": 554,
        "platform": "BTC",
        "tx_id": "5d3c394304a52aeb7f0a055e3cbabce6462962db3009f2ca84da5247bc4bf710"
    }
}

# GET Acquire the Number of Confirmations

/{coin}/v1/tx/confirmation

Acquire the number of confirmations through the abbreviation of the public chain and tx hash.

params type required note
tx_id string yes the translation hash to be review

The return content format is as follows:

{
    "code":0,
    "message":"OK",
    "data":{
        "confirmation": 554,                                                         // confirmations
        "platform": "BTC",                                                           // token name
        "tx_id": "5d3c394304a52aeb7f0a055e3cbabce6462962db3009f2ca84da5247bc4bf710"  // tx hash
    }
}

Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/btc/v1/tx/confirmation?tx_id=5d3c394304a52aeb7f0a055e3cbabce6462962db3009f2ca84da5247bc4bf710
'
Example Response
200 OK
{
    "code":0,
    "message":"OK",
    "data":{
        "confirmation": 554,
        "platform": "BTC",
        "tx_id": "5d3c394304a52aeb7f0a055e3cbabce6462962db3009f2ca84da5247bc4bf710"
    }
}

# GET Acquire Block Transaction List

/{coin}/v1/block/txs

Acquire the transaction list of the block through the public chain abbreviation and block height.

params type required note
height int64 yes block height
nextkey string no query cursor

The return content format is as follows:

{
    "code": 0,
    "data": {
        "items": [
            {
                "id": "c7841cb796c64027391038673de23d2b242fd2108c1e7092b9207cf6ef46ecb8",  // tx hash
                "fee": "-313828",                                                          // fee
                "date": 1617109308,                                                        // date 
                "block": 676997,                                                           // block height
                "confirmation": 966,                                                       // confirmations
                "status": "completed",                                                     // transaction status
                "inputs": [                                                                // transaction inputs
                    {
                        "addresses": [                                                     // address list
                            "13vDqiRpJ7h9oSri85e6wonvgtKYbVXiHp"
                        ],
                        "tx": "5d3c394304a52aeb7f0a055e3cbabce6462962db3009f2ca84da5247bc4bf710", // inputted tx hash
                        "script_sig": "483045022100ae07c018a81ce86cd0324ff13cd5bbee4064180b818ec491d9aa6c63ccc84ae702202bb4040c6c94d6509a0cd56fe3625968dccbd3308d1cd2d0376f9f145f3f033b01210360c5c6cd2c7f93b68c834ca38ba27f9a2f6f4d74153bf0bc007cd17c8bda1cbf",                                                       // signature
                        "type": "pubkeyhash",
                        "value": 347238,                                                    // value
                        "vfp": 1,
                        "sequence": 4294967295
                    },
                    {
                        "tx": "83e6deea63ea60d2265a0fc3b1e41fa2b5d78e16543c6efb19694721786c01e8",
                        "script_sig": "473044022078b9464543b0e028e897aab1212cf8c9fe3b1fdbef7d603d7511e97a4f4c05820220224035cbadbd31b565b61985c50e25fd3eff678fdc0b147155f2d07de6b5e8cc012102c625fbd4a74117a739ee5489ccd98e3e824f8406adaec3274bed4699cf53f675",
                        "value": 0,
                        "vfp": 0,
                        "sequence": 4294967295
                    }
                ],
                "outputs": [                                                                // transaction outputs
                    {
                        "addresses": [
                            "1AYnQmwWYuomJaJGNkUKkaGdi9Hdfjtkct"
                        ],
                        "script": "76a91468bbeee32eab032e8865d2ec07ff479a7ad8304288ac",
                        "type": "pubkeyhash",
                        "next_tx_id": "8f4d66d927b55cc90c6a7641bc85bf80aed3bd694b6f1b04ac09671cd0389dda",
                        "value": 307895,
                        "n": 0,
                        "next_position": 0
                    },
                    {
                        "addresses": [
                            "12JaDBoKxyz5UkzLj4hJqFkqJczY1FjZqs"
                        ],
                        "script": "76a9140e4aeb66a77a89e013d63e852232998031c8910e88ac",
                        "type": "pubkeyhash",
                        "next_tx_id": "9e7cff97dfdeb08c158bf8e7fb22288562bf21bec6e61f20fa035893f4b2fb10",
                        "value": 353171,
                        "n": 1,
                        "next_position": 3
                    }
                ],
                "memo": "",
                "metadata": null
            },
        ],
        "nextkey": "B1jgkPtsA1FQR21eYU",
        "page": 0
    },
    "message": "OK"
}
Example Request
curl --location --request GET 'http://developers.viawallet.com/openapi/api/btc/v1/block/txs?height=675639' \
--header 'X-API-Key: BRfvZY97QaRa14Ci1F5vvP3KzwRxFFMw'
Example Response
200 OK
{
    "code": 0,
    "data": {
        "items": [
            {
                "id": "3193f588fb1bcede00e809562dbdb07be94779e1ac90ffe95c7f4eeaea94af07",
                "fee": "0",
                "date": 1616340678,
                "block": 675639,
                "is_coinbase": true,
                "confirmation": 2314,
                "status": "completed",
                "inputs": [
                    {
                        "witness": [
                            "0000000000000000000000000000000000000000000000000000000000000000"
                        ],
                        "coinbase": "03374f0a04c6665760425443506f6f6cfabe6d6d78bd61a6381485d1fd757c08ca151acf8605357e6cfa591776eccda28bbf7b21020000007296cd100300e37527641c0000000000",
                        "value": 0,
                        "vfp": 4294967295,
                        "sequence": 4294967295
                    }
                ],
                "outputs": [
                    {
                        "addresses": [
                            "14PUSkxZsGShcNmUBmxcYm5DcFq89S8jEG"
                        ],
                        "script": "76a9142528700ca7564d29160a93e629243d4ca15777e788ac",
                        "type": "pubkeyhash",
                        "value": 650979097,
                        "n": 0,
                        "next_position": 0
                    },
                    {
                        "script": "6a24aa21a9ed2e336a4a683fb65e51eee595ebfd9d29ecb4c2b4ea65bb2489be3565db7e77e7",
                        "type": "nulldata",
                        "value": 0,
                        "n": 1,
                        "next_position": 0
                    }
                ],
                "memo": "",
                "metadata": null
            },
        ],
        "nextkey": "",
    },
    "message": "OK"
}

# GET Acquire Block Transaction List

/{coin}/v1/block/txs

Acquire the transaction list of the block through the public chain abbreviation and block height.

params type required note
height int64 yes block height
nextkey string no query cursor

The return content format is as follows:

{
    "code": 0,
    "data": {
        "items": [
            {
                "id": "c7841cb796c64027391038673de23d2b242fd2108c1e7092b9207cf6ef46ecb8",  // tx hash
                "fee": "-313828",                                                          // fee
                "date": 1617109308,                                                        // date 
                "block": 676997,                                                           // block height
                "confirmation": 966,                                                       // confirmations
                "status": "completed",                                                     // transaction status
                "inputs": [                                                                // transaction inputs
                    {
                        "addresses": [                                                     // address list
                            "13vDqiRpJ7h9oSri85e6wonvgtKYbVXiHp"
                        ],
                        "tx": "5d3c394304a52aeb7f0a055e3cbabce6462962db3009f2ca84da5247bc4bf710", // inputted tx hash
                        "script_sig": "483045022100ae07c018a81ce86cd0324ff13cd5bbee4064180b818ec491d9aa6c63ccc84ae702202bb4040c6c94d6509a0cd56fe3625968dccbd3308d1cd2d0376f9f145f3f033b01210360c5c6cd2c7f93b68c834ca38ba27f9a2f6f4d74153bf0bc007cd17c8bda1cbf",                                                       // signature
                        "type": "pubkeyhash",
                        "value": 347238,                                                    // value
                        "vfp": 1,
                        "sequence": 4294967295
                    },
                    {
                        "tx": "83e6deea63ea60d2265a0fc3b1e41fa2b5d78e16543c6efb19694721786c01e8",
                        "script_sig": "473044022078b9464543b0e028e897aab1212cf8c9fe3b1fdbef7d603d7511e97a4f4c05820220224035cbadbd31b565b61985c50e25fd3eff678fdc0b147155f2d07de6b5e8cc012102c625fbd4a74117a739ee5489ccd98e3e824f8406adaec3274bed4699cf53f675",
                        "value": 0,
                        "vfp": 0,
                        "sequence": 4294967295
                    }
                ],
                "outputs": [                                                                // transaction outputs
                    {
                        "addresses": [
                            "1AYnQmwWYuomJaJGNkUKkaGdi9Hdfjtkct"
                        ],
                        "script": "76a91468bbeee32eab032e8865d2ec07ff479a7ad8304288ac",
                        "type": "pubkeyhash",
                        "next_tx_id": "8f4d66d927b55cc90c6a7641bc85bf80aed3bd694b6f1b04ac09671cd0389dda",
                        "value": 307895,
                        "n": 0,
                        "next_position": 0
                    },
                    {
                        "addresses": [
                            "12JaDBoKxyz5UkzLj4hJqFkqJczY1FjZqs"
                        ],
                        "script": "76a9140e4aeb66a77a89e013d63e852232998031c8910e88ac",
                        "type": "pubkeyhash",
                        "next_tx_id": "9e7cff97dfdeb08c158bf8e7fb22288562bf21bec6e61f20fa035893f4b2fb10",
                        "value": 353171,
                        "n": 1,
                        "next_position": 3
                    }
                ],
                "memo": "",
                "metadata": null
            },
        ],
        "nextkey": "B1jgkPtsA1FQR21eYU",
        "page": 0
    },
    "message": "OK"
}
Example Request
curl --location --request GET 'http://developers.viawallet.com/openapi/api/btc/v1/block/txs?height=675639' \
--header 'X-API-Key: BRfvZY97QaRa14Ci1F5vvP3KzwRxFFMw'
Example Response
200 OK
{
    "code": 0,
    "data": {
        "items": [
            {
                "id": "3193f588fb1bcede00e809562dbdb07be94779e1ac90ffe95c7f4eeaea94af07",
                "fee": "0",
                "date": 1616340678,
                "block": 675639,
                "is_coinbase": true,
                "confirmation": 2314,
                "status": "completed",
                "inputs": [
                    {
                        "witness": [
                            "0000000000000000000000000000000000000000000000000000000000000000"
                        ],
                        "coinbase": "03374f0a04c6665760425443506f6f6cfabe6d6d78bd61a6381485d1fd757c08ca151acf8605357e6cfa591776eccda28bbf7b21020000007296cd100300e37527641c0000000000",
                        "value": 0,
                        "vfp": 4294967295,
                        "sequence": 4294967295
                    }
                ],
                "outputs": [
                    {
                        "addresses": [
                            "14PUSkxZsGShcNmUBmxcYm5DcFq89S8jEG"
                        ],
                        "script": "76a9142528700ca7564d29160a93e629243d4ca15777e788ac",
                        "type": "pubkeyhash",
                        "value": 650979097,
                        "n": 0,
                        "next_position": 0
                    },
                    {
                        "script": "6a24aa21a9ed2e336a4a683fb65e51eee595ebfd9d29ecb4c2b4ea65bb2489be3565db7e77e7",
                        "type": "nulldata",
                        "value": 0,
                        "n": 1,
                        "next_position": 0
                    }
                ],
                "memo": "",
                "metadata": null
            },
        ],
        "nextkey": "",
    },
    "message": "OK"
}

# GET Acquire Pending Transaction Status

/{coin}/v1/unconfirmed_tx

The pending transaction means that it is still waiting to be packaged and has not yet entered the blockchain. Get the details of this transaction through the txid and the abbreviation of the public chain. If data returns null, there is no transaction in the queue to be confirmed.

params type required note
tx_id string yes the translation hash to be review

The return content format is as follows:

{
    "code": 0,
    "message": "OK",
    "data": {
        "id": "816da806c69ec920e279c1d88aec48cd4c8da6be53634b9aab17ae64a3e0a090",       // tx hash
        "fee": "11658",                                                                 // fee
        "date": 1616481573,                                                             // date 
        "block": 0,
        "confirmation": 0,
        "status": "pending",                                                            // transaction status
        "inputs": [                                                                     // transaction inputs
            {
                "addresses": [
                    "bc1q9akj4ekp0u4wrqlf9wmkcgna7y5wnn2x0uwhtz"
                ],
                "tx": "d4a758fbf0ce1dc9b1d7a9fb2cae232a8bffa6d830300b05be48047d1103af33",
                "type": "witness_v0_keyhash",
                "value": 2058732,
                "vfp": 0,
                "sequence": 4294967295
            }
        ],
        "outputs": [                                                                    // transaction ouputs
            {
                "addresses": [
                    "35HFgtPENNGnR4UdyUUPRapVhUUQjQhFBD"
                ],
                "script": "a9142762029659834c03bb0470d82567a8ebde838e2687",
                "type": "scripthash",
                "value": 2047074,
                "n": 0,
                "next_position": 0,
            }
        ],
        "memo": "",
        "metadata": null
    }
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/btc/v1/unconfirmed_tx/816da806c69ec920e279c1d88aec48cd4c8da6be53634b9aab17ae64a3e0a090'
Example Response
200 OK
{
    "code": 0,
    "message": "OK",
    "data": {
        "id": "816da806c69ec920e279c1d88aec48cd4c8da6be53634b9aab17ae64a3e0a090",
        "fee": "11658",
        "date": 1616481573,
        "block": 0,
        "confirmation": 0,
        "status": "pending",
        "inputs": [
            {
                "addresses": [
                    "bc1q9akj4ekp0u4wrqlf9wmkcgna7y5wnn2x0uwhtz"
                ],
                "tx": "d4a758fbf0ce1dc9b1d7a9fb2cae232a8bffa6d830300b05be48047d1103af33",
                "type": "witness_v0_keyhash",
                "value": 2058732,
                "vfp": 0,
                "sequence": 4294967295
            }
        ],
        "outputs": [
            {
                "addresses": [
                    "35HFgtPENNGnR4UdyUUPRapVhUUQjQhFBD"
                ],
                "script": "a9142762029659834c03bb0470d82567a8ebde838e2687",
                "type": "scripthash",
                "value": 2047074,
                "n": 0,
                "next_position": 0,
            }
        ],
        "memo": "",
        "metadata": null
    }
}

# GET Acquire Pending Transaction Status

/{coin}/v1/unconfirmed_tx

The pending transaction means that it is still waiting to be packaged and has not yet entered the blockchain. Get the details of this transaction through the txid and the abbreviation of the public chain. If data returns null, there is no transaction in the queue to be confirmed.

params type required note
tx_id string yes the translation hash to be review

The return content format is as follows:

{
    "code": 0,
    "message": "OK",
    "data": {
        "id": "816da806c69ec920e279c1d88aec48cd4c8da6be53634b9aab17ae64a3e0a090",       // tx hash
        "fee": "11658",                                                                 // fee
        "date": 1616481573,                                                             // date 
        "block": 0,
        "confirmation": 0,
        "status": "pending",                                                            // transaction status
        "inputs": [                                                                     // transaction inputs
            {
                "addresses": [
                    "bc1q9akj4ekp0u4wrqlf9wmkcgna7y5wnn2x0uwhtz"
                ],
                "tx": "d4a758fbf0ce1dc9b1d7a9fb2cae232a8bffa6d830300b05be48047d1103af33",
                "type": "witness_v0_keyhash",
                "value": 2058732,
                "vfp": 0,
                "sequence": 4294967295
            }
        ],
        "outputs": [                                                                    // transaction ouputs
            {
                "addresses": [
                    "35HFgtPENNGnR4UdyUUPRapVhUUQjQhFBD"
                ],
                "script": "a9142762029659834c03bb0470d82567a8ebde838e2687",
                "type": "scripthash",
                "value": 2047074,
                "n": 0,
                "next_position": 0,
            }
        ],
        "memo": "",
        "metadata": null
    }
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/btc/v1/unconfirmed_tx/816da806c69ec920e279c1d88aec48cd4c8da6be53634b9aab17ae64a3e0a090'
Example Response
200 OK
{
    "code": 0,
    "message": "OK",
    "data": {
        "id": "816da806c69ec920e279c1d88aec48cd4c8da6be53634b9aab17ae64a3e0a090",
        "fee": "11658",
        "date": 1616481573,
        "block": 0,
        "confirmation": 0,
        "status": "pending",
        "inputs": [
            {
                "addresses": [
                    "bc1q9akj4ekp0u4wrqlf9wmkcgna7y5wnn2x0uwhtz"
                ],
                "tx": "d4a758fbf0ce1dc9b1d7a9fb2cae232a8bffa6d830300b05be48047d1103af33",
                "type": "witness_v0_keyhash",
                "value": 2058732,
                "vfp": 0,
                "sequence": 4294967295
            }
        ],
        "outputs": [
            {
                "addresses": [
                    "35HFgtPENNGnR4UdyUUPRapVhUUQjQhFBD"
                ],
                "script": "a9142762029659834c03bb0470d82567a8ebde838e2687",
                "type": "scripthash",
                "value": 2047074,
                "n": 0,
                "next_position": 0,
            }
        ],
        "memo": "",
        "metadata": null
    }
}

# GET Top 100 Rich Addresses of Coin

/{coin}/v1/toprich

Get the TOP 100 wallet address list on the public chains via the abbreviation of the public chain, including the wallet balance, and the list is sorted by the descending order of the balance. Supported coins: BTC, BCH, BSV, LTC, DOGE, FCH

The return content format is as follows:

{
    "code": 0,
    "message": "OK",
    "data": [
        {
            "address": "3D2oetdNuZUqQHPJmcMDDHYoqkyNVsFk9r", // address
            "balance": 138660.86073724,                      // balance of address
            "percent":13.4,                                  // percent
            "first_tx_time":1333003647,                      // date of the first tx
            "last_tx_time":1616981507,                       // date of the latest tx
            "tx_count":1352,                                 // total tx count
            "tx_30day_count":13                              // total tx count of last 30 days

        },
    ...
    ]
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/btc/v1/toprich'
Example Response
200 OK
{
    "code": 0,
    "message": "OK",
    "data": [
        {
            "address": "3D2oetdNuZUqQHPJmcMDDHYoqkyNVsFk9r",
            "balance": 138660.86073724,
            "percent":13.4,
            "first_tx_time":1333003647,
            "last_tx_time":1616981507,
            "tx_count":1352,
            "tx_30day_count":13

        },
        {
            "addr": "16ftSEQ4ctQFDtVZiUBusQUjRrGhM3JYwe",
            "balance": 138660.86073724,
            "percent":13.4,
            "first_tx_time":1333003647,
            "last_tx_time":1616981507,
            "tx_count":1352,
            "tx_30day_count":13
        },
        {
            "addr": "16rCmCmbuWDhPjWTrpQGaU3EPdZF7MTdUk",
            "balance": 138660.86073724,
            "percent":13.4,
            "first_tx_time":1333003647,
            "last_tx_time":1616981507,
            "tx_count":1352,
            "tx_30day_count":13
        }
    ...
    ]
}

# GET Top 100 Rich Addresses of Coin

/{coin}/v1/toprich

Get the TOP 100 wallet address list on the public chains via the abbreviation of the public chain, including the wallet balance, and the list is sorted by the descending order of the balance. Supported coins: BTC, BCH, BSV, LTC, DOGE, FCH

The return content format is as follows:

{
    "code": 0,
    "message": "OK",
    "data": [
        {
            "address": "3D2oetdNuZUqQHPJmcMDDHYoqkyNVsFk9r", // address
            "balance": 138660.86073724,                      // balance of address
            "percent":13.4,                                  // percent
            "first_tx_time":1333003647,                      // date of the first tx
            "last_tx_time":1616981507,                       // date of the latest tx
            "tx_count":1352,                                 // total tx count
            "tx_30day_count":13                              // total tx count of last 30 days

        },
    ...
    ]
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/btc/v1/toprich'
Example Response
200 OK
{
    "code": 0,
    "message": "OK",
    "data": [
        {
            "address": "3D2oetdNuZUqQHPJmcMDDHYoqkyNVsFk9r",
            "balance": 138660.86073724,
            "percent":13.4,
            "first_tx_time":1333003647,
            "last_tx_time":1616981507,
            "tx_count":1352,
            "tx_30day_count":13

        },
        {
            "addr": "16ftSEQ4ctQFDtVZiUBusQUjRrGhM3JYwe",
            "balance": 138660.86073724,
            "percent":13.4,
            "first_tx_time":1333003647,
            "last_tx_time":1616981507,
            "tx_count":1352,
            "tx_30day_count":13
        },
        {
            "addr": "16rCmCmbuWDhPjWTrpQGaU3EPdZF7MTdUk",
            "balance": 138660.86073724,
            "percent":13.4,
            "first_tx_time":1333003647,
            "last_tx_time":1616981507,
            "tx_count":1352,
            "tx_30day_count":13
        }
    ...
    ]
}

# ETH and Other Similar Coins

# GET Inquire Public Chain Basic Info

/{coin}/v1/chain/info

Obtain basic info of public chain via its abbreviations, such as block height, tx count, total circulating supply of native coins, network size etc. Respond format as follows:

{
    "symbol": "ETH",                                                            // Coin/Token ticker
    "name": "Ethereum",                                                         // Coin/Token full name
    "decimals": 18,                                                             // Decimal
    "block_time": 10000,                                                        // Block time
    "sample_address": "0xfc10cab6a50a1ab10c56983c80cc82afc6559cf1",             // Sample address
    "height": 10216016,                                                         // Current block height
    "hash": "0x1f9bb990d7a25a1c77652d6fcf6631ecc681bcd9d59722c1d0e21c7c68607e89",// Current block hash
    "size": 70390928311,                                                        // Chain size, the current field may not be returned
    "tota_txs": 29045598,                                                       // Total transactions, the current field may not be returned
    "circulation":16923962                                                      // Network circulation, the current field may not be returned
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/eth/v1/chain/info'
Example Response
200 OK
{

  "code": 0,
  "message": "OK",
  "data": {
    "symbol": "ETH",
    "name": "Ethereum",
    "decimals": 18,
    "block_time": 10000,
    "sample_address": "0xfc10cab6a50a1ab10c56983c80cc82afc6559cf1",
    "height": 10216016,
    "hash": "0x1f9bb990d7a25a1c77652d6fcf6631ecc681bcd9d59722c1d0e21c7c68607e89",
    "size": 70390928311,
    "tota_txs": 29045598
  }
}

# ETH and Other Similar Coins

# GET Inquire Public Chain Basic Info

/{coin}/v1/chain/info

Obtain basic info of public chain via its abbreviations, such as block height, tx count, total circulating supply of native coins, network size etc. Respond format as follows:

{
    "symbol": "ETH",                                                            // Coin/Token ticker
    "name": "Ethereum",                                                         // Coin/Token full name
    "decimals": 18,                                                             // Decimal
    "block_time": 10000,                                                        // Block time
    "sample_address": "0xfc10cab6a50a1ab10c56983c80cc82afc6559cf1",             // Sample address
    "height": 10216016,                                                         // Current block height
    "hash": "0x1f9bb990d7a25a1c77652d6fcf6631ecc681bcd9d59722c1d0e21c7c68607e89",// Current block hash
    "size": 70390928311,                                                        // Chain size, the current field may not be returned
    "tota_txs": 29045598,                                                       // Total transactions, the current field may not be returned
    "circulation":16923962                                                      // Network circulation, the current field may not be returned
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/eth/v1/chain/info'
Example Response
200 OK
{

  "code": 0,
  "message": "OK",
  "data": {
    "symbol": "ETH",
    "name": "Ethereum",
    "decimals": 18,
    "block_time": 10000,
    "sample_address": "0xfc10cab6a50a1ab10c56983c80cc82afc6559cf1",
    "height": 10216016,
    "hash": "0x1f9bb990d7a25a1c77652d6fcf6631ecc681bcd9d59722c1d0e21c7c68607e89",
    "size": 70390928311,
    "tota_txs": 29045598
  }
}

# GET Acquire Block Info

/{coin}/v1/block

Acquire block information based on block height or hash

params type required note
hashOrHeight string yes Block hash or height

Return format as follows:

{
    "code": 0,
    "data": {
        "date": 1620532384,                                                                 // Timestamp
        "height": 10200000,                                                                 // Block height
        "hash": "0x02c3b44b44364a08b29ecb1ad93615b5752b65780923cc47e3f607f3e3e8bc61",       // Block hash
        "confirmations": 16016,                                                             // Number of confirmation
        "txs": [                                                                            // Tx list
            "0xb4817c6215ecd045a946d0438c8ed357bf2af4075dabd56b77ff2b93f40665c6",           // Txid
            "0x8a23c23a7813843bb7bf16fc51e822832cb4168f99658d7c6ed21a13d1db1622"
        ],
        "size": 1030,                                                                       // Block size
        "nonce": "0x1e331705118e777e",                                                      // nonce value
        "parent_hash": "0xc12ed2c4d2219e7da137c6b0b79a7896615c2d85838ca50e4ef1036eba1c70cf",// Hash of previous block
        "state_root": "0x0699c41f5b84a6adad9770265c1f2e838a555e81738ac03c5e6ccea146604c14"  // Merkel root
    },
    "message": "OK"
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/eth/v1/block?hashOrHeight=0x02c3b44b44364a08b29ecb1ad93615b5752b65780923cc47e3f607f3e3e8bc61'

Example Response
200 OK
{
    "code": 0,
    "data": {
        "date": 1620532384,
        "height": 10200000,
        "hash": "0x02c3b44b44364a08b29ecb1ad93615b5752b65780923cc47e3f607f3e3e8bc61",
        "confirmations": 16016,
        "txs": [
            "0xb4817c6215ecd045a946d0438c8ed357bf2af4075dabd56b77ff2b93f40665c6",
            "0x8a23c23a7813843bb7bf16fc51e822832cb4168f99658d7c6ed21a13d1db1622"
        ],
        "size": 1030,
        "nonce": "0x1e331705118e777e",
        "parent_hash": "0xc12ed2c4d2219e7da137c6b0b79a7896615c2d85838ca50e4ef1036eba1c70cf",
        "state_root": "0x0699c41f5b84a6adad9770265c1f2e838a555e81738ac03c5e6ccea146604c14"
    },
    "message": "OK"
}

# GET Acquire Block Info

/{coin}/v1/block

Acquire block information based on block height or hash

params type required note
hashOrHeight string yes Block hash or height

Return format as follows:

{
    "code": 0,
    "data": {
        "date": 1620532384,                                                                 // Timestamp
        "height": 10200000,                                                                 // Block height
        "hash": "0x02c3b44b44364a08b29ecb1ad93615b5752b65780923cc47e3f607f3e3e8bc61",       // Block hash
        "confirmations": 16016,                                                             // Number of confirmation
        "txs": [                                                                            // Tx list
            "0xb4817c6215ecd045a946d0438c8ed357bf2af4075dabd56b77ff2b93f40665c6",           // Txid
            "0x8a23c23a7813843bb7bf16fc51e822832cb4168f99658d7c6ed21a13d1db1622"
        ],
        "size": 1030,                                                                       // Block size
        "nonce": "0x1e331705118e777e",                                                      // nonce value
        "parent_hash": "0xc12ed2c4d2219e7da137c6b0b79a7896615c2d85838ca50e4ef1036eba1c70cf",// Hash of previous block
        "state_root": "0x0699c41f5b84a6adad9770265c1f2e838a555e81738ac03c5e6ccea146604c14"  // Merkel root
    },
    "message": "OK"
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/eth/v1/block?hashOrHeight=0x02c3b44b44364a08b29ecb1ad93615b5752b65780923cc47e3f607f3e3e8bc61'

Example Response
200 OK
{
    "code": 0,
    "data": {
        "date": 1620532384,
        "height": 10200000,
        "hash": "0x02c3b44b44364a08b29ecb1ad93615b5752b65780923cc47e3f607f3e3e8bc61",
        "confirmations": 16016,
        "txs": [
            "0xb4817c6215ecd045a946d0438c8ed357bf2af4075dabd56b77ff2b93f40665c6",
            "0x8a23c23a7813843bb7bf16fc51e822832cb4168f99658d7c6ed21a13d1db1622"
        ],
        "size": 1030,
        "nonce": "0x1e331705118e777e",
        "parent_hash": "0xc12ed2c4d2219e7da137c6b0b79a7896615c2d85838ca50e4ef1036eba1c70cf",
        "state_root": "0x0699c41f5b84a6adad9770265c1f2e838a555e81738ac03c5e6ccea146604c14"
    },
    "message": "OK"
}

# GET Acquire Address Detailed Info

/{coin}/v1/address/info

Acquire address info via public chain abbreviation and address, including: Balance, balance ranking, tx count, transfer count, reception count and the details of last tx

params type required note
address string yes address to be inquired

The return format is as follows:

{
    "code": 0,
    "data": {
        "address": "0x2f2f15b7f8be36f1dc812d333ed5f6acf19b535b",   // address
        "balance": 0,                                              // address balance
        "total_txs": 6,                                            // total transaction count
        "total_tx_in": "5",                                        // received amount
        "total_tx_out": "4.999979",                                // transferred amount
        "latest_tx": {                                             // last transaction
            "id": "0x769641a0893bf49e1cf8609592971b45e189dac5808d815d2dbed119f9f121ed",
            "type": "transfer",
            "gas_limit": 21000,
            "gas_price": "1000000000",
            "gas_used": 21000,
            "from": "0x2f2f15b7f8be36f1dc812d333ed5f6acf19b535b",
            "to": "0x9402d510491f5dfde5e0b338831c80727c96222f",
            "fee": "21000000000000",
            "date": 1620721687,
            "block": 10212967,
            "confirmation": 0,
            "status": "completed",
            "metadata": []
        }
    },
    "message": "OK"
}
Example Request
curl --localtion --request GET 'https://developers.viawallet.com/openapi/api/eth/v1/address/info?address=0x2f2f15b7f8be36f1dc812d333ed5f6acf19b535b'
Example Response
200 OK
{
    "code": 0,
    "data": {
        "address": "0x2f2f15b7f8be36f1dc812d333ed5f6acf19b535b",                      
        "balance": 0,                                                                
        "total_txs": 6,                                                               
        "total_tx_in": "5",                                                           
        "total_tx_out": "4.999979",                                                  
        "latest_tx": {                                                                
            "id": "0x769641a0893bf49e1cf8609592971b45e189dac5808d815d2dbed119f9f121ed",
            "type": "transfer",
            "gas_limit": 21000,
            "gas_price": "1000000000",
            "gas_used": 21000,
            "from": "0x2f2f15b7f8be36f1dc812d333ed5f6acf19b535b",
            "to": "0x9402d510491f5dfde5e0b338831c80727c96222f",
            "fee": "21000000000000",
            "date": 1620721687,
            "block": 10212967,
            "confirmation": 0,
            "status": "completed",
            "metadata": []
        }
    },
    "message": "OK"
}

# GET Acquire Address Detailed Info

/{coin}/v1/address/info

Acquire address info via public chain abbreviation and address, including: Balance, balance ranking, tx count, transfer count, reception count and the details of last tx

params type required note
address string yes address to be inquired

The return format is as follows:

{
    "code": 0,
    "data": {
        "address": "0x2f2f15b7f8be36f1dc812d333ed5f6acf19b535b",   // address
        "balance": 0,                                              // address balance
        "total_txs": 6,                                            // total transaction count
        "total_tx_in": "5",                                        // received amount
        "total_tx_out": "4.999979",                                // transferred amount
        "latest_tx": {                                             // last transaction
            "id": "0x769641a0893bf49e1cf8609592971b45e189dac5808d815d2dbed119f9f121ed",
            "type": "transfer",
            "gas_limit": 21000,
            "gas_price": "1000000000",
            "gas_used": 21000,
            "from": "0x2f2f15b7f8be36f1dc812d333ed5f6acf19b535b",
            "to": "0x9402d510491f5dfde5e0b338831c80727c96222f",
            "fee": "21000000000000",
            "date": 1620721687,
            "block": 10212967,
            "confirmation": 0,
            "status": "completed",
            "metadata": []
        }
    },
    "message": "OK"
}
Example Request
curl --localtion --request GET 'https://developers.viawallet.com/openapi/api/eth/v1/address/info?address=0x2f2f15b7f8be36f1dc812d333ed5f6acf19b535b'
Example Response
200 OK
{
    "code": 0,
    "data": {
        "address": "0x2f2f15b7f8be36f1dc812d333ed5f6acf19b535b",                      
        "balance": 0,                                                                
        "total_txs": 6,                                                               
        "total_tx_in": "5",                                                           
        "total_tx_out": "4.999979",                                                  
        "latest_tx": {                                                                
            "id": "0x769641a0893bf49e1cf8609592971b45e189dac5808d815d2dbed119f9f121ed",
            "type": "transfer",
            "gas_limit": 21000,
            "gas_price": "1000000000",
            "gas_used": 21000,
            "from": "0x2f2f15b7f8be36f1dc812d333ed5f6acf19b535b",
            "to": "0x9402d510491f5dfde5e0b338831c80727c96222f",
            "fee": "21000000000000",
            "date": 1620721687,
            "block": 10212967,
            "confirmation": 0,
            "status": "completed",
            "metadata": []
        }
    },
    "message": "OK"
}

# GET Transaction List of the Acquired Address

/{coin}/v1/address/txs

Acquire tx history list of the address via public chain abbreviation and address

params type required note
address string yes address to be inquired
nextkey string no query cursor

Returned info format as follows:

{
    "code": 0,
    "data": {
        "items": [
            {
                "id": "0xb56eb930f96015f4d9bf6a1f63aac259abed6f447057e5b7f0d35d88a3af2163", // txid
                "gas_limit": 21000,                                                         // gas limit
                "gas_price": "117000000000",                                                // gas price
                "gas_used": 21000,                                                          // gas used
                "nonce": 173,                                                               // nonce value
                "from": "0xdb248d1ab299e2f453eb06d5ef5b1db531996cb1",                       // from
                "to": "0x58edb19ded9d46e0f76743722fce137b13daaedb",                         // to
                "fee": "2457000000000000",                                                  // tx fee
                "date": 1620551470,                                                         // timestamp
                "block": 10201359,                                                          // block height
                "confirmation": 14657,                                                      // number of confirmation
                "status": "completed",                                                      // tx status
                "metadata": []
            }
        ],
        "nextkey": "",
    },
    "message": "OK"
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/eth/v1/txs?address=0xdb248d1ab299e2f453eb06d5ef5b1db531996cb1'

Example Response
200 OK
{
    "code": 0,
    "data": {
        "items": [
            {
                "id": "0xb56eb930f96015f4d9bf6a1f63aac259abed6f447057e5b7f0d35d88a3af2163", 
                "gas_limit": 21000,                                                        
                "gas_price": "117000000000",                                               
                "gas_used": 21000,                                                         
                "nonce": 173,                                                              
                "from": "0xdb248d1ab299e2f453eb06d5ef5b1db531996cb1",                      
                "to": "0x58edb19ded9d46e0f76743722fce137b13daaedb",                        
                "fee": "2457000000000000",                                                 
                "date": 1620551470,                                                        
                "block": 10201359,                                                         
                "confirmation": 14657,                                                     
                "status": "completed",                                                     
                "metadata": []
            }
        ],
        "nextkey": "",
    },
    "message": "OK"
}

# GET Transaction List of the Acquired Address

/{coin}/v1/address/txs

Acquire tx history list of the address via public chain abbreviation and address

params type required note
address string yes address to be inquired
nextkey string no query cursor

Returned info format as follows:

{
    "code": 0,
    "data": {
        "items": [
            {
                "id": "0xb56eb930f96015f4d9bf6a1f63aac259abed6f447057e5b7f0d35d88a3af2163", // txid
                "gas_limit": 21000,                                                         // gas limit
                "gas_price": "117000000000",                                                // gas price
                "gas_used": 21000,                                                          // gas used
                "nonce": 173,                                                               // nonce value
                "from": "0xdb248d1ab299e2f453eb06d5ef5b1db531996cb1",                       // from
                "to": "0x58edb19ded9d46e0f76743722fce137b13daaedb",                         // to
                "fee": "2457000000000000",                                                  // tx fee
                "date": 1620551470,                                                         // timestamp
                "block": 10201359,                                                          // block height
                "confirmation": 14657,                                                      // number of confirmation
                "status": "completed",                                                      // tx status
                "metadata": []
            }
        ],
        "nextkey": "",
    },
    "message": "OK"
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/eth/v1/txs?address=0xdb248d1ab299e2f453eb06d5ef5b1db531996cb1'

Example Response
200 OK
{
    "code": 0,
    "data": {
        "items": [
            {
                "id": "0xb56eb930f96015f4d9bf6a1f63aac259abed6f447057e5b7f0d35d88a3af2163", 
                "gas_limit": 21000,                                                        
                "gas_price": "117000000000",                                               
                "gas_used": 21000,                                                         
                "nonce": 173,                                                              
                "from": "0xdb248d1ab299e2f453eb06d5ef5b1db531996cb1",                      
                "to": "0x58edb19ded9d46e0f76743722fce137b13daaedb",                        
                "fee": "2457000000000000",                                                 
                "date": 1620551470,                                                        
                "block": 10201359,                                                         
                "confirmation": 14657,                                                     
                "status": "completed",                                                     
                "metadata": []
            }
        ],
        "nextkey": "",
    },
    "message": "OK"
}

# GET Acquire List of Transactions To Be Confirmed

/{coin}/v1/unconfirmed_txs

Supported coins: ETH, ETC, BNB, HT

Acquire the list of txs to be confirmed on the address via public chain abbreviation

params type required note
address string no address to be inquired
nextkey string no query cursor

The return content format is as follows:

{
    "code": 0,
    "data": {
        "items": [
            {
                "id": "0xb56eb930f96015f4d9bf6a1f63aac259abed6f447057e5b7f0d35d88a3af2163", // txid
                "gas_limit": 90908,                                                         // gas limit
                "gas_price": "1000000000",                                                  // gas price
                "gas_used": 0,                                                              // gas used
                "nonce": 173,                                                               // nonce value
                "from": "0xdb248d1ab299e2f453eb06d5ef5b1db531996cb1",                       // from
                "to": "0x58edb19ded9d46e0f76743722fce137b13daaedb",                         // to
                "fee": "",                                                                  // tx fee
                "date": 0,                                                                  // timestamp
                "block": 0,                                                                 // block height
                "confirmation": 0,                                                          // number of confirmation
                "status": "pending",                                                        // tx status
                "metadata": []
            }
        ],
        "nextkey": "",
    },
    "message": "OK"
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/eth/v1/unconfirmed_txs?address=0x4fe2000fb08b8059e1898cec0426b6d89228622b'

Example Response
200 OK
{
    "code": 0,
    "data": {
        "items": [
            {
                "id": "0xd35fcba7210d6de56711810685a867e4fc183ec4212825671ff768a8465d8e8f",
                "gas_limit": 90908,
                "gas_price": "1000000000",
                "gas_used": 0,
                "nonce": 554,
                "from": "0x4fe2000fb08b8059e1898cec0426b6d89228622b",
                "to": "0x0cc6cc19a03d005708e4b0985fdf4dee44639ee5",
                "fee": "",
                "date": 0,
                "block": 0,
                "confirmation": 0,
                "status": "pending",
                "metadata": []
            },
            {
                "id": "0x8490f7517869a0dde863d84d181976be134f3fba23aae9e0c84a57d179fe111e",
                "gas_limit": 90908,
                "gas_price": "1000000000",
                "gas_used": 0,
                "nonce": 553,
                "from": "0x4fe2000fb08b8059e1898cec0426b6d89228622b",
                "to": "0x0cc6cc19a03d005708e4b0985fdf4dee44639ee5",
                "fee": "",
                "date": 0,
                "block": 0,
                "confirmation": 0,
                "status": "pending",
                "metadata": []
            }
        ],
        "nextkey": "",
    },
    "message": "OK"
}

# GET Acquire List of Transactions To Be Confirmed

/{coin}/v1/unconfirmed_txs

Supported coins: ETH, ETC, BNB, HT

Acquire the list of txs to be confirmed on the address via public chain abbreviation

params type required note
address string no address to be inquired
nextkey string no query cursor

The return content format is as follows:

{
    "code": 0,
    "data": {
        "items": [
            {
                "id": "0xb56eb930f96015f4d9bf6a1f63aac259abed6f447057e5b7f0d35d88a3af2163", // txid
                "gas_limit": 90908,                                                         // gas limit
                "gas_price": "1000000000",                                                  // gas price
                "gas_used": 0,                                                              // gas used
                "nonce": 173,                                                               // nonce value
                "from": "0xdb248d1ab299e2f453eb06d5ef5b1db531996cb1",                       // from
                "to": "0x58edb19ded9d46e0f76743722fce137b13daaedb",                         // to
                "fee": "",                                                                  // tx fee
                "date": 0,                                                                  // timestamp
                "block": 0,                                                                 // block height
                "confirmation": 0,                                                          // number of confirmation
                "status": "pending",                                                        // tx status
                "metadata": []
            }
        ],
        "nextkey": "",
    },
    "message": "OK"
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/eth/v1/unconfirmed_txs?address=0x4fe2000fb08b8059e1898cec0426b6d89228622b'

Example Response
200 OK
{
    "code": 0,
    "data": {
        "items": [
            {
                "id": "0xd35fcba7210d6de56711810685a867e4fc183ec4212825671ff768a8465d8e8f",
                "gas_limit": 90908,
                "gas_price": "1000000000",
                "gas_used": 0,
                "nonce": 554,
                "from": "0x4fe2000fb08b8059e1898cec0426b6d89228622b",
                "to": "0x0cc6cc19a03d005708e4b0985fdf4dee44639ee5",
                "fee": "",
                "date": 0,
                "block": 0,
                "confirmation": 0,
                "status": "pending",
                "metadata": []
            },
            {
                "id": "0x8490f7517869a0dde863d84d181976be134f3fba23aae9e0c84a57d179fe111e",
                "gas_limit": 90908,
                "gas_price": "1000000000",
                "gas_used": 0,
                "nonce": 553,
                "from": "0x4fe2000fb08b8059e1898cec0426b6d89228622b",
                "to": "0x0cc6cc19a03d005708e4b0985fdf4dee44639ee5",
                "fee": "",
                "date": 0,
                "block": 0,
                "confirmation": 0,
                "status": "pending",
                "metadata": []
            }
        ],
        "nextkey": "",
    },
    "message": "OK"
}

# GET Details of A Singular Transaction

/{coin}/v1/tx

Acquire tx details via public chain abbreviation and tx hash. For the gas limit, gas price and gas used of ont and vet, use ong and vtho respectively.

params type required note
tx_id string yes tx hash to be inquired

The return content format is as follows:

{
    "code": 0,
    "data": {
         "id": "0xb56eb930f96015f4d9bf6a1f63aac259abed6f447057e5b7f0d35d88a3af2163", // txid
        "gas_limit": 21000,                                                         // gas limit
        "gas_price": "117000000000",                                                // gas price
        "gas_used": 21000,                                                          // gas used
        "nonce": 173,                                                               // nonce value
        "from": "0xdb248d1ab299e2f453eb06d5ef5b1db531996cb1",                       // from
        "to": "0x58edb19ded9d46e0f76743722fce137b13daaedb",                         // to
        "fee": "2457000000000000",                                                  // tx fee
        "date": 1620551470,                                                         // timestamp
        "block": 10201359,                                                          // block height
        "confirmation": 14657,                                                      // number of confirmation
        "status": "completed",                                                      // tx status
        "metadata": []
    },
    "message": "OK"
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/eth/v1/tx?tx_id=0x8a23c23a7813843bb7bf16fc51e822832cb4168f99658d7c6ed21a13d1db1622'

Example Response
200 OK

{
    "code": 0,
    "data": {
        "id": "0x8a23c23a7813843bb7bf16fc51e822832cb4168f99658d7c6ed21a13d1db1622",
        "gas_limit": 21000,
        "gas_price": "100000000000",
        "gas_used": 21000,
        "nonce": 2619,
        "from": "0xc5fade3198fe1f8bed3ec25b3d68bf9a8ddf934f",
        "to": "0xeb547a7354e6fe0da3bae56c1efe9a76ac5a7519",
        "fee": "2100000000000000",
        "date": 1620532384,
        "block": 10200000,
        "confirmation": 16016,
        "status": "completed",
        "metadata": []
    },
    "message": "OK"
}

# GET Details of A Singular Transaction

/{coin}/v1/tx

Acquire tx details via public chain abbreviation and tx hash. For the gas limit, gas price and gas used of ont and vet, use ong and vtho respectively.

params type required note
tx_id string yes tx hash to be inquired

The return content format is as follows:

{
    "code": 0,
    "data": {
         "id": "0xb56eb930f96015f4d9bf6a1f63aac259abed6f447057e5b7f0d35d88a3af2163", // txid
        "gas_limit": 21000,                                                         // gas limit
        "gas_price": "117000000000",                                                // gas price
        "gas_used": 21000,                                                          // gas used
        "nonce": 173,                                                               // nonce value
        "from": "0xdb248d1ab299e2f453eb06d5ef5b1db531996cb1",                       // from
        "to": "0x58edb19ded9d46e0f76743722fce137b13daaedb",                         // to
        "fee": "2457000000000000",                                                  // tx fee
        "date": 1620551470,                                                         // timestamp
        "block": 10201359,                                                          // block height
        "confirmation": 14657,                                                      // number of confirmation
        "status": "completed",                                                      // tx status
        "metadata": []
    },
    "message": "OK"
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/eth/v1/tx?tx_id=0x8a23c23a7813843bb7bf16fc51e822832cb4168f99658d7c6ed21a13d1db1622'

Example Response
200 OK

{
    "code": 0,
    "data": {
        "id": "0x8a23c23a7813843bb7bf16fc51e822832cb4168f99658d7c6ed21a13d1db1622",
        "gas_limit": 21000,
        "gas_price": "100000000000",
        "gas_used": 21000,
        "nonce": 2619,
        "from": "0xc5fade3198fe1f8bed3ec25b3d68bf9a8ddf934f",
        "to": "0xeb547a7354e6fe0da3bae56c1efe9a76ac5a7519",
        "fee": "2100000000000000",
        "date": 1620532384,
        "block": 10200000,
        "confirmation": 16016,
        "status": "completed",
        "metadata": []
    },
    "message": "OK"
}

# GET Number of Confirmation For a Singular Transaction

/{coin}/v1/tx/confirmation

Acquire confirmation number of tx via public chain abbreviation and tx hash

params type required note
tx_id string yes tx hash to be inquired

The return content format is as follows:

{
    "code": 0,
    "data": {
        "confirmation": 16016,                                                          // confirmations
        "platform": "ETH",                                                              // token name
        "tx_id": "0x8a23c23a7813843bb7bf16fc51e822832cb4168f99658d7c6ed21a13d1db1622"   // tx hash
    },
    "message": "OK"
}

Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/eth/v1/tx/confirmation?tx_id=0x8a23c23a7813843bb7bf16fc51e822832cb4168f99658d7c6ed21a13d1db1622
'
Example Response
200 OK
{
    "code": 0,
    "data": {
        "confirmation": 16016,
        "platform": "eth",
        "tx_id": "0x8a23c23a7813843bb7bf16fc51e822832cb4168f99658d7c6ed21a13d1db1622"
    },
    "message": "OK"
}

# GET Number of Confirmation For a Singular Transaction

/{coin}/v1/tx/confirmation

Acquire confirmation number of tx via public chain abbreviation and tx hash

params type required note
tx_id string yes tx hash to be inquired

The return content format is as follows:

{
    "code": 0,
    "data": {
        "confirmation": 16016,                                                          // confirmations
        "platform": "ETH",                                                              // token name
        "tx_id": "0x8a23c23a7813843bb7bf16fc51e822832cb4168f99658d7c6ed21a13d1db1622"   // tx hash
    },
    "message": "OK"
}

Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/eth/v1/tx/confirmation?tx_id=0x8a23c23a7813843bb7bf16fc51e822832cb4168f99658d7c6ed21a13d1db1622
'
Example Response
200 OK
{
    "code": 0,
    "data": {
        "confirmation": 16016,
        "platform": "eth",
        "tx_id": "0x8a23c23a7813843bb7bf16fc51e822832cb4168f99658d7c6ed21a13d1db1622"
    },
    "message": "OK"
}

# GET Acquire Block Transaction List

/{coin}/v1/block/txs

Acquire tx list at this block height via public chain abbreviation and block height

params type required note
height int64 yes block height
nextkey string no query cursor

Returned info format as follows:


{
    "code": 0,
    "data": {
        "items": [
            {
                "id": "0x3a5c680b49451775b67ad9b4846e553c5bd12fbd9e0d77dafd184b3a023e2b1b", // txid
                "type": "token_transfer",                                           // tx type, token_transfer for tx transferred token、contract_call for tx called contract,transfer for normal tx
                "gas_limit": 139979,                                                // gas limit
                "gas_price": "1000000000",                                          // gas price
                "gas_used": 102040,                                                 // gas used
                "nonce": 31,                                                        // tx nonce
                "from": "0x3c98189b52fb2e1da681026d4f965ea4f2b7b13c",               // from
                "to": "0x7a250d5630b4cf539739df2c5dacb4c659f2488d",                 // to
                "fee": "102040000000000",                                           // fee
                "date": 1620730114,                                                 // tx timestamp
                "block": 10213589,                                                  // block height
                "confirmation": 2427,                                               // number of confirmation
                "status": "completed",                                              // tx status
                "token_transfers": [                                                // token tx info
                    {
                        "index": 1,         
                        "token_id": "0xc778417e063141139fce010982780140aa0cd5ab",   // token id (contract)
                        "type": "",
                        "value": "100000000000000000",                              // value
                        "from": "0x7a250d5630b4cf539739df2c5dacb4c659f2488d",
                        "to": "0xd695dc9f79cf0b0f8c23e7f01aec354403747a3f"
                    },
                    {
                        "index": 2,
                        "token_id": "0x902b2a515c43256158fde75f7de6f155e4a45c14",
                        "type": "",
                        "value": "344876432180959503648615581383",
                        "from": "0xd695dc9f79cf0b0f8c23e7f01aec354403747a3f",
                        "to": "0x3c98189b52fb2e1da681026d4f965ea4f2b7b13c"
                    }
                ],
                "metadata": []
            }
           {
                "id": "0x553d77deaddcdc5e5f69867ad60fba9f63d874f3d15f0cafdfc6098b87550928",
                "type": "transfer",
                "gas_limit": 400000,
                "gas_price": "2000000000",
                "gas_used": 273385,
                "nonce": 2,
                "from": "0x15b31e86cd118040db66fb8b14d5be658a9b71a7",
                "to": "0xa10d0c6e04845a5e998d1936249a30563c553417",
                "fee": "546770000000000",
                "date": 1616569886,
                "value": "0",
                "block": 9900000,
                "confirmation": 509675,
                "status": "completed",
                "contract_call": [                                                  //  Contract call info
                    {
                        "contract": "0x5ea9ea8e80230e514b5e023e8d956550a22d02c6",   // contract address
                        "input":        "0xd98380ea00000000000000000000000000000000000000000000000000000000000000c00000000000000000000000000000000000000000000000000000000000000100cd54fa0c503bcd81e680e9f910531ee4dafbe0602ed0c9ae193af44213be0f16000000000000000000000000000000000000000000000000000000000000001c185f5e43b4bc10fa7a9db2f5e25bf1a966dba79148b120ef78d3828b32692d174bda81b9a01561505f612ef43245a336c2d88824aff6f66ac2d14917137d68d1000000000000000000000000000000000000000000000000000000000000000100100000000000000000000000000000ecdf4636493d43529141b53274a69803000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000003635c9adc5dea00000"
                    }                                                               // input
                ],
                "metadata": []
            },
        ],
        "nextkey": "",
    },
    "message": "OK"
}

Example Request
curl --location --request GET 'http://developers.viawallet.com/openapi/api/eth/v1/block/txs?height=10213589' \
--header 'X-API-Key: BRfvZY97QaRa14Ci1F5vvP3KzwRxFFMw'
Example Response
200 OK

{
    "code": 0,
    "data": {
        "items": [
            {
                "id": "0x3a5c680b49451775b67ad9b4846e553c5bd12fbd9e0d77dafd184b3a023e2b1b", 
                "type": "token_transfer",                                          
                "gas_limit": 139979,                                              
                "gas_price": "1000000000",                                        
                "gas_used": 102040,                                                
                "nonce": 31,                                                      
                "from": "0x3c98189b52fb2e1da681026d4f965ea4f2b7b13c",              
                "to": "0x7a250d5630b4cf539739df2c5dacb4c659f2488d",               
                "fee": "102040000000000",                                          
                "date": 1620730114,                                               
                "block": 10213589,                                                
                "confirmation": 2427,                                             
                "status": "completed",                                            
                "token_transfers": [                                              
                    {
                        "index": 1,         
                        "token_id": "0xc778417e063141139fce010982780140aa0cd5ab",  
                        "type": "",
                        "value": "100000000000000000",                              
                        "from": "0x7a250d5630b4cf539739df2c5dacb4c659f2488d",
                        "to": "0xd695dc9f79cf0b0f8c23e7f01aec354403747a3f"
                    },
                    {
                        "index": 2,
                        "token_id": "0x902b2a515c43256158fde75f7de6f155e4a45c14",
                        "type": "",
                        "value": "344876432180959503648615581383",
                        "from": "0xd695dc9f79cf0b0f8c23e7f01aec354403747a3f",
                        "to": "0x3c98189b52fb2e1da681026d4f965ea4f2b7b13c"
                    }
                ],
                "metadata": []
            }
           {
                "id": "0x553d77deaddcdc5e5f69867ad60fba9f63d874f3d15f0cafdfc6098b87550928",
                "type": "transfer",
                "gas_limit": 400000,
                "gas_price": "2000000000",
                "gas_used": 273385,
                "nonce": 2,
                "from": "0x15b31e86cd118040db66fb8b14d5be658a9b71a7",
                "to": "0xa10d0c6e04845a5e998d1936249a30563c553417",
                "fee": "546770000000000",
                "date": 1616569886,
                "value": "0",
                "block": 9900000,
                "confirmation": 509675,
                "status": "completed",
                "contract_call": [                                                 
                    {
                        "contract": "0x5ea9ea8e80230e514b5e023e8d956550a22d02c6",   
                        "input":        "0xd98380ea00000000000000000000000000000000000000000000000000000000000000c00000000000000000000000000000000000000000000000000000000000000100cd54fa0c503bcd81e680e9f910531ee4dafbe0602ed0c9ae193af44213be0f16000000000000000000000000000000000000000000000000000000000000001c185f5e43b4bc10fa7a9db2f5e25bf1a966dba79148b120ef78d3828b32692d174bda81b9a01561505f612ef43245a336c2d88824aff6f66ac2d14917137d68d1000000000000000000000000000000000000000000000000000000000000000100100000000000000000000000000000ecdf4636493d43529141b53274a69803000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000003635c9adc5dea00000"
                    }                                                            
                ],
                "metadata": []
            },
        ],
        "nextkey": "",
    },
    "message": "OK"
}

# GET Acquire Block Transaction List

/{coin}/v1/block/txs

Acquire tx list at this block height via public chain abbreviation and block height

params type required note
height int64 yes block height
nextkey string no query cursor

Returned info format as follows:


{
    "code": 0,
    "data": {
        "items": [
            {
                "id": "0x3a5c680b49451775b67ad9b4846e553c5bd12fbd9e0d77dafd184b3a023e2b1b", // txid
                "type": "token_transfer",                                           // tx type, token_transfer for tx transferred token、contract_call for tx called contract,transfer for normal tx
                "gas_limit": 139979,                                                // gas limit
                "gas_price": "1000000000",                                          // gas price
                "gas_used": 102040,                                                 // gas used
                "nonce": 31,                                                        // tx nonce
                "from": "0x3c98189b52fb2e1da681026d4f965ea4f2b7b13c",               // from
                "to": "0x7a250d5630b4cf539739df2c5dacb4c659f2488d",                 // to
                "fee": "102040000000000",                                           // fee
                "date": 1620730114,                                                 // tx timestamp
                "block": 10213589,                                                  // block height
                "confirmation": 2427,                                               // number of confirmation
                "status": "completed",                                              // tx status
                "token_transfers": [                                                // token tx info
                    {
                        "index": 1,         
                        "token_id": "0xc778417e063141139fce010982780140aa0cd5ab",   // token id (contract)
                        "type": "",
                        "value": "100000000000000000",                              // value
                        "from": "0x7a250d5630b4cf539739df2c5dacb4c659f2488d",
                        "to": "0xd695dc9f79cf0b0f8c23e7f01aec354403747a3f"
                    },
                    {
                        "index": 2,
                        "token_id": "0x902b2a515c43256158fde75f7de6f155e4a45c14",
                        "type": "",
                        "value": "344876432180959503648615581383",
                        "from": "0xd695dc9f79cf0b0f8c23e7f01aec354403747a3f",
                        "to": "0x3c98189b52fb2e1da681026d4f965ea4f2b7b13c"
                    }
                ],
                "metadata": []
            }
           {
                "id": "0x553d77deaddcdc5e5f69867ad60fba9f63d874f3d15f0cafdfc6098b87550928",
                "type": "transfer",
                "gas_limit": 400000,
                "gas_price": "2000000000",
                "gas_used": 273385,
                "nonce": 2,
                "from": "0x15b31e86cd118040db66fb8b14d5be658a9b71a7",
                "to": "0xa10d0c6e04845a5e998d1936249a30563c553417",
                "fee": "546770000000000",
                "date": 1616569886,
                "value": "0",
                "block": 9900000,
                "confirmation": 509675,
                "status": "completed",
                "contract_call": [                                                  //  Contract call info
                    {
                        "contract": "0x5ea9ea8e80230e514b5e023e8d956550a22d02c6",   // contract address
                        "input":        "0xd98380ea00000000000000000000000000000000000000000000000000000000000000c00000000000000000000000000000000000000000000000000000000000000100cd54fa0c503bcd81e680e9f910531ee4dafbe0602ed0c9ae193af44213be0f16000000000000000000000000000000000000000000000000000000000000001c185f5e43b4bc10fa7a9db2f5e25bf1a966dba79148b120ef78d3828b32692d174bda81b9a01561505f612ef43245a336c2d88824aff6f66ac2d14917137d68d1000000000000000000000000000000000000000000000000000000000000000100100000000000000000000000000000ecdf4636493d43529141b53274a69803000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000003635c9adc5dea00000"
                    }                                                               // input
                ],
                "metadata": []
            },
        ],
        "nextkey": "",
    },
    "message": "OK"
}

Example Request
curl --location --request GET 'http://developers.viawallet.com/openapi/api/eth/v1/block/txs?height=10213589' \
--header 'X-API-Key: BRfvZY97QaRa14Ci1F5vvP3KzwRxFFMw'
Example Response
200 OK

{
    "code": 0,
    "data": {
        "items": [
            {
                "id": "0x3a5c680b49451775b67ad9b4846e553c5bd12fbd9e0d77dafd184b3a023e2b1b", 
                "type": "token_transfer",                                          
                "gas_limit": 139979,                                              
                "gas_price": "1000000000",                                        
                "gas_used": 102040,                                                
                "nonce": 31,                                                      
                "from": "0x3c98189b52fb2e1da681026d4f965ea4f2b7b13c",              
                "to": "0x7a250d5630b4cf539739df2c5dacb4c659f2488d",               
                "fee": "102040000000000",                                          
                "date": 1620730114,                                               
                "block": 10213589,                                                
                "confirmation": 2427,                                             
                "status": "completed",                                            
                "token_transfers": [                                              
                    {
                        "index": 1,         
                        "token_id": "0xc778417e063141139fce010982780140aa0cd5ab",  
                        "type": "",
                        "value": "100000000000000000",                              
                        "from": "0x7a250d5630b4cf539739df2c5dacb4c659f2488d",
                        "to": "0xd695dc9f79cf0b0f8c23e7f01aec354403747a3f"
                    },
                    {
                        "index": 2,
                        "token_id": "0x902b2a515c43256158fde75f7de6f155e4a45c14",
                        "type": "",
                        "value": "344876432180959503648615581383",
                        "from": "0xd695dc9f79cf0b0f8c23e7f01aec354403747a3f",
                        "to": "0x3c98189b52fb2e1da681026d4f965ea4f2b7b13c"
                    }
                ],
                "metadata": []
            }
           {
                "id": "0x553d77deaddcdc5e5f69867ad60fba9f63d874f3d15f0cafdfc6098b87550928",
                "type": "transfer",
                "gas_limit": 400000,
                "gas_price": "2000000000",
                "gas_used": 273385,
                "nonce": 2,
                "from": "0x15b31e86cd118040db66fb8b14d5be658a9b71a7",
                "to": "0xa10d0c6e04845a5e998d1936249a30563c553417",
                "fee": "546770000000000",
                "date": 1616569886,
                "value": "0",
                "block": 9900000,
                "confirmation": 509675,
                "status": "completed",
                "contract_call": [                                                 
                    {
                        "contract": "0x5ea9ea8e80230e514b5e023e8d956550a22d02c6",   
                        "input":        "0xd98380ea00000000000000000000000000000000000000000000000000000000000000c00000000000000000000000000000000000000000000000000000000000000100cd54fa0c503bcd81e680e9f910531ee4dafbe0602ed0c9ae193af44213be0f16000000000000000000000000000000000000000000000000000000000000001c185f5e43b4bc10fa7a9db2f5e25bf1a966dba79148b120ef78d3828b32692d174bda81b9a01561505f612ef43245a336c2d88824aff6f66ac2d14917137d68d1000000000000000000000000000000000000000000000000000000000000000100100000000000000000000000000000ecdf4636493d43529141b53274a69803000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000003635c9adc5dea00000"
                    }                                                            
                ],
                "metadata": []
            },
        ],
        "nextkey": "",
    },
    "message": "OK"
}

# GET Acquire Unconfirmed Transactions

/{coin}/v1/unconfirmed_tx

Supported coins: ETH, ETC, BNB, HT

The tx to be confirmed means that the tx is still pending for package and has not yet entered the blockchain. Tx details can be obtained via txid and public chain abbreviation. If data returns null, it means that there is no such tx in the queue to be confirmed.

params type required note
tx_id string yes tx hash to be inquired

The return content format is as follows:

{
    "code": 0,
    "data": {
        "id": "0xb56eb930f96015f4d9bf6a1f63aac259abed6f447057e5b7f0d35d88a3af2163", // tx hash
        "gas_limit": 21000,                                                         // gas limit
        "gas_price": "117000000000",                                                // gas price
        "gas_used": 0,                                                              // gas used
        "nonce": 173,                                                               // nonce value
        "from": "0xdb248d1ab299e2f453eb06d5ef5b1db531996cb1",                       // from
        "to": "0x58edb19ded9d46e0f76743722fce137b13daaedb",                         // to
        "fee": "",                                                                  // tx fee
        "date": 0,                                                                  // timestamp
        "block": 0,                                                                 // block height
        "confirmation": 0,                                                          // number of confirmation
        "status": "pending",                                                        // tx status
        "metadata": []
    },
    "message": "OK"
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/eth/v1/unconfirmed_tx/0x57cde10fd9c4ea53e3a0df68860c18b02c7b45fda298f0d92ded4d5368feb87a'
Example Response
200 OK

{
    "code": 0,
    "data": {
        "id": "0x57cde10fd9c4ea53e3a0df68860c18b02c7b45fda298f0d92ded4d5368feb87a",
        "gas_limit": 90908,
        "gas_price": "1000000000",
        "gas_used": 0,
        "nonce": 552,
        "from": "0x4fe2000fb08b8059e1898cec0426b6d89228622b",
        "to": "0x0cc6cc19a03d005708e4b0985fdf4dee44639ee5",
        "fee": "",
        "date": 0,
        "block": 0,
        "confirmation": 0,
        "status": "pending",
        "metadata": []
    },
    "message": "OK"
}

# GET Acquire Unconfirmed Transactions

/{coin}/v1/unconfirmed_tx

Supported coins: ETH, ETC, BNB, HT

The tx to be confirmed means that the tx is still pending for package and has not yet entered the blockchain. Tx details can be obtained via txid and public chain abbreviation. If data returns null, it means that there is no such tx in the queue to be confirmed.

params type required note
tx_id string yes tx hash to be inquired

The return content format is as follows:

{
    "code": 0,
    "data": {
        "id": "0xb56eb930f96015f4d9bf6a1f63aac259abed6f447057e5b7f0d35d88a3af2163", // tx hash
        "gas_limit": 21000,                                                         // gas limit
        "gas_price": "117000000000",                                                // gas price
        "gas_used": 0,                                                              // gas used
        "nonce": 173,                                                               // nonce value
        "from": "0xdb248d1ab299e2f453eb06d5ef5b1db531996cb1",                       // from
        "to": "0x58edb19ded9d46e0f76743722fce137b13daaedb",                         // to
        "fee": "",                                                                  // tx fee
        "date": 0,                                                                  // timestamp
        "block": 0,                                                                 // block height
        "confirmation": 0,                                                          // number of confirmation
        "status": "pending",                                                        // tx status
        "metadata": []
    },
    "message": "OK"
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/eth/v1/unconfirmed_tx/0x57cde10fd9c4ea53e3a0df68860c18b02c7b45fda298f0d92ded4d5368feb87a'
Example Response
200 OK

{
    "code": 0,
    "data": {
        "id": "0x57cde10fd9c4ea53e3a0df68860c18b02c7b45fda298f0d92ded4d5368feb87a",
        "gas_limit": 90908,
        "gas_price": "1000000000",
        "gas_used": 0,
        "nonce": 552,
        "from": "0x4fe2000fb08b8059e1898cec0426b6d89228622b",
        "to": "0x0cc6cc19a03d005708e4b0985fdf4dee44639ee5",
        "fee": "",
        "date": 0,
        "block": 0,
        "confirmation": 0,
        "status": "pending",
        "metadata": []
    },
    "message": "OK"
}

# GET Acquire Token List

/{coin}/v1/tokens

Supported coins: ETH, ETC, BNB, HT, TRX

Returned info format as follows:


{
    "code": 0,
    "data": {
        "items": [
             {
                "name": "Wandoge2",                                         // token name
                "symbol": "WANDOGE2",                                       // token ticker
                "decimals": 18,                                             // token decimal
                "token_id": "0xfbb94a3966da67e12170d6662d2fa99f07f0b4d5",   // token id(contract)
                "coin": "eth",                                              // coin
                "holder_count": 2                                           // holder count
            },
            ...
        ],
        "nextkey": "M6zHaZxAXCe",
    },
    "message": "OK"
}

Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/eth/v1/tokens'
Example Response
200 OK

{
    "code": 0,
    "data": {
        "items": [
             {
                "name": "Wandoge2",                                       
                "symbol": "WANDOGE2",                                     
                "decimals": 18,                                           
                "token_id": "0xfbb94a3966da67e12170d6662d2fa99f07f0b4d5",  
                "coin": "eth",                                            
                "holder_count": 2                                          
            },
            {
                "name": "Tesla Stock TOKEN",
                "symbol": "TSLA",
                "decimals": 18,
                "token_id": "0xfb588e297332e3dfb1af06296c4765cee5c15494",
                "coin": "eth"
            },
            {
                "name": "TMCOW",
                "symbol": "COW",
                "decimals": 18,
                "token_id": "0xfb4af01c76960e34572a962d0d3d07dd2dee0f46",
                "coin": "eth"
            },
            {
                "name": "FaucetToken",
                "symbol": "FAU",
                "decimals": 18,
                "token_id": "0xfab46e002bbf0b4509813474841e0716e6730136",
                "coin": "eth"
            },
            {
                "name": "Wandoge2",
                "symbol": "WANDOGE2",
                "decimals": 18,
                "token_id": "0xf9fcd33c2fa6d0c228fb74d3138258d4d4c017a5",
                "coin": "eth"
            },
            {
                "name": "TEST CONTRACT",
                "symbol": "XRP",
                "decimals": 18,
                "token_id": "0xf9b3e3690083f0deb4855aece0e74a7f520b950e",
                "coin": "eth"
            },
            {
                "name": "PUN",
                "symbol": "PUN",
                "decimals": 18,
                "token_id": "0xf9527c6bd7153cc2f46ac816a24aec24dd5913d5",
                "coin": "eth"
            },
            {
                "name": "GridZone.io",
                "symbol": "ZONE",
                "decimals": 18,
                "token_id": "0xf884d04e282f859f694c691eb19a618646cdcf10",
                "coin": "eth"
            },
            {
                "name": "Wandoge",
                "symbol": "WANDOGE",
                "decimals": 18,
                "token_id": "0xf70b5285078ba3c116a05cb7bedb59acc3f852f2",
                "coin": "eth"
            }
        ],
        "nextkey": "M6zHaZxAXCe",
    },
    "message": "OK"
}

# GET Acquire Token List

/{coin}/v1/tokens

Supported coins: ETH, ETC, BNB, HT, TRX

Returned info format as follows:


{
    "code": 0,
    "data": {
        "items": [
             {
                "name": "Wandoge2",                                         // token name
                "symbol": "WANDOGE2",                                       // token ticker
                "decimals": 18,                                             // token decimal
                "token_id": "0xfbb94a3966da67e12170d6662d2fa99f07f0b4d5",   // token id(contract)
                "coin": "eth",                                              // coin
                "holder_count": 2                                           // holder count
            },
            ...
        ],
        "nextkey": "M6zHaZxAXCe",
    },
    "message": "OK"
}

Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/eth/v1/tokens'
Example Response
200 OK

{
    "code": 0,
    "data": {
        "items": [
             {
                "name": "Wandoge2",                                       
                "symbol": "WANDOGE2",                                     
                "decimals": 18,                                           
                "token_id": "0xfbb94a3966da67e12170d6662d2fa99f07f0b4d5",  
                "coin": "eth",                                            
                "holder_count": 2                                          
            },
            {
                "name": "Tesla Stock TOKEN",
                "symbol": "TSLA",
                "decimals": 18,
                "token_id": "0xfb588e297332e3dfb1af06296c4765cee5c15494",
                "coin": "eth"
            },
            {
                "name": "TMCOW",
                "symbol": "COW",
                "decimals": 18,
                "token_id": "0xfb4af01c76960e34572a962d0d3d07dd2dee0f46",
                "coin": "eth"
            },
            {
                "name": "FaucetToken",
                "symbol": "FAU",
                "decimals": 18,
                "token_id": "0xfab46e002bbf0b4509813474841e0716e6730136",
                "coin": "eth"
            },
            {
                "name": "Wandoge2",
                "symbol": "WANDOGE2",
                "decimals": 18,
                "token_id": "0xf9fcd33c2fa6d0c228fb74d3138258d4d4c017a5",
                "coin": "eth"
            },
            {
                "name": "TEST CONTRACT",
                "symbol": "XRP",
                "decimals": 18,
                "token_id": "0xf9b3e3690083f0deb4855aece0e74a7f520b950e",
                "coin": "eth"
            },
            {
                "name": "PUN",
                "symbol": "PUN",
                "decimals": 18,
                "token_id": "0xf9527c6bd7153cc2f46ac816a24aec24dd5913d5",
                "coin": "eth"
            },
            {
                "name": "GridZone.io",
                "symbol": "ZONE",
                "decimals": 18,
                "token_id": "0xf884d04e282f859f694c691eb19a618646cdcf10",
                "coin": "eth"
            },
            {
                "name": "Wandoge",
                "symbol": "WANDOGE",
                "decimals": 18,
                "token_id": "0xf70b5285078ba3c116a05cb7bedb59acc3f852f2",
                "coin": "eth"
            }
        ],
        "nextkey": "M6zHaZxAXCe",
    },
    "message": "OK"
}

# GET Acquire Token Detailed Info

/{coin}/v1/token

Supported coins: ETH, ETC, BNB, HT, TRX

params type required note
token_id string yes token id to be inquired

Returned info format as follows:


{
    "code": 0,
    "data": {
        "name": "Wandoge2",                                         // token name
        "symbol": "WANDOGE2",                                       // token ticker
        "decimals": 18,                                             // token decimal
        "token_id": "0xfbb94a3966da67e12170d6662d2fa99f07f0b4d5",   // token id(contract)
        "coin": "eth",                                              // coin
        "holder_count": 2                                           // holder count
    },
    "message": "OK"
}

Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/eth/v1/token?token_id=0xf4beccb8440cfebbbd8a324623c1b2cce9b55ad6'
Example Response
200 OK

{
    "code": 0,
    "data": {
        "name": "Qkika Token",
        "symbol": "Qkika",
        "decimals": 6,
        "token_id": "0xf4beccb8440cfebbbd8a324623c1b2cce9b55ad6",
        "coin": "eth"
    },
    "message": "OK"
}

# GET Acquire Token Detailed Info

/{coin}/v1/token

Supported coins: ETH, ETC, BNB, HT, TRX

params type required note
token_id string yes token id to be inquired

Returned info format as follows:


{
    "code": 0,
    "data": {
        "name": "Wandoge2",                                         // token name
        "symbol": "WANDOGE2",                                       // token ticker
        "decimals": 18,                                             // token decimal
        "token_id": "0xfbb94a3966da67e12170d6662d2fa99f07f0b4d5",   // token id(contract)
        "coin": "eth",                                              // coin
        "holder_count": 2                                           // holder count
    },
    "message": "OK"
}

Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/eth/v1/token?token_id=0xf4beccb8440cfebbbd8a324623c1b2cce9b55ad6'
Example Response
200 OK

{
    "code": 0,
    "data": {
        "name": "Qkika Token",
        "symbol": "Qkika",
        "decimals": 6,
        "token_id": "0xf4beccb8440cfebbbd8a324623c1b2cce9b55ad6",
        "coin": "eth"
    },
    "message": "OK"
}

# GET Acquire Token Transaction List

/{coin}/v1/token/txs

Pass the address parameter to get the transaction of a certain address and inquire tx list of the token Supported currencies: ETH, ETC, BNB, HT, TRX

params type required note
token_id string no token id to be inquired
address string no address to be inquired

token id params and address params cannot be blank at the same time

The return content format is as follows:



{
    "code": 0,
    "data": {
        "items": [
        {
            "id": "0x3a5c680b49451775b67ad9b4846e553c5bd12fbd9e0d77dafd184b3a023e2b1b", // tx hash
            "type": "token_transfer",                                                   // tx type, token_transfer for tx transferred token、contract_call for tx called contract,transfer for normal tx
            "gas_limit": 139979,                                                        // gas limit   
            "gas_price": "1000000000",                                                  // gas price
            "gas_used": 102040,                                                         // gas used
            "nonce": 31,                                                                // nonce value
            "from": "0x3c98189b52fb2e1da681026d4f965ea4f2b7b13c",                       // from  
            "to": "0x7a250d5630b4cf539739df2c5dacb4c659f2488d",                         // to
            "fee": "102040000000000",                                                   // tx fee
            "date": 1620730114,                                                         // timestamp
            "block": 10213589,                                                          // block height
            "confirmation": 2427,                                                       // confirmations
            "status": "completed",                                                      // tx status
            "token_transfers": [                                               
                {
                    "index": 1,                                                         // packed index
                    "token_id": "0xc778417e063141139fce010982780140aa0cd5ab",           // token id (contract address)
                    "type": "",         
                    "value": "100000000000000000",                                      // value
                    "from": "0x7a250d5630b4cf539739df2c5dacb4c659f2488d",               // from
                    "to": "0xd695dc9f79cf0b0f8c23e7f01aec354403747a3f"                  // to
                },
                {
                    "index": 2,
                    "token_id": "0x902b2a515c43256158fde75f7de6f155e4a45c14",
                    "type": "",
                    "value": "344876432180959503648615581383",
                    "from": "0xd695dc9f79cf0b0f8c23e7f01aec354403747a3f",
                    "to": "0x3c98189b52fb2e1da681026d4f965ea4f2b7b13c"
                }
            ],
            "metadata": []
        }
        ],
        "nextkey": "",
    },
    "message": "OK"
}

Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/eth/v1/token/txs?token_id=0xc778417e063141139fce010982780140aa0cd5ab'
Example Response
200 OK


{
    "code": 0,
    "data": {
        "items": [
        {
            "id": "0x3a5c680b49451775b67ad9b4846e553c5bd12fbd9e0d77dafd184b3a023e2b1b",
            "type": "token_transfer",                                          
            "gas_limit": 139979,                                              
            "gas_price": "1000000000",                                         
            "gas_used": 102040,                                                
            "nonce": 31,                                                       
            "from": "0x3c98189b52fb2e1da681026d4f965ea4f2b7b13c",               
            "to": "0x7a250d5630b4cf539739df2c5dacb4c659f2488d",                
            "fee": "102040000000000",                                          
            "date": 1620730114,                                                
            "block": 10213589,                                                 
            "confirmation": 2427,                                               
            "status": "completed",                                             
            "token_transfers": [                                               
                {
                    "index": 1,         
                    "token_id": "0xc778417e063141139fce010982780140aa0cd5ab",   
                    "type": "",
                    "value": "100000000000000000",                             
                    "from": "0x7a250d5630b4cf539739df2c5dacb4c659f2488d",
                    "to": "0xd695dc9f79cf0b0f8c23e7f01aec354403747a3f"
                },
                {
                    "index": 2,
                    "token_id": "0x902b2a515c43256158fde75f7de6f155e4a45c14",
                    "type": "",
                    "value": "344876432180959503648615581383",
                    "from": "0xd695dc9f79cf0b0f8c23e7f01aec354403747a3f",
                    "to": "0x3c98189b52fb2e1da681026d4f965ea4f2b7b13c"
                }
            ],
            "metadata": []
        }
        ],
        "nextkey": "",
    },
    "message": "OK"
}

# GET Acquire Token Transaction List

/{coin}/v1/token/txs

Pass the address parameter to get the transaction of a certain address and inquire tx list of the token Supported currencies: ETH, ETC, BNB, HT, TRX

params type required note
token_id string no token id to be inquired
address string no address to be inquired

token id params and address params cannot be blank at the same time

The return content format is as follows:



{
    "code": 0,
    "data": {
        "items": [
        {
            "id": "0x3a5c680b49451775b67ad9b4846e553c5bd12fbd9e0d77dafd184b3a023e2b1b", // tx hash
            "type": "token_transfer",                                                   // tx type, token_transfer for tx transferred token、contract_call for tx called contract,transfer for normal tx
            "gas_limit": 139979,                                                        // gas limit   
            "gas_price": "1000000000",                                                  // gas price
            "gas_used": 102040,                                                         // gas used
            "nonce": 31,                                                                // nonce value
            "from": "0x3c98189b52fb2e1da681026d4f965ea4f2b7b13c",                       // from  
            "to": "0x7a250d5630b4cf539739df2c5dacb4c659f2488d",                         // to
            "fee": "102040000000000",                                                   // tx fee
            "date": 1620730114,                                                         // timestamp
            "block": 10213589,                                                          // block height
            "confirmation": 2427,                                                       // confirmations
            "status": "completed",                                                      // tx status
            "token_transfers": [                                               
                {
                    "index": 1,                                                         // packed index
                    "token_id": "0xc778417e063141139fce010982780140aa0cd5ab",           // token id (contract address)
                    "type": "",         
                    "value": "100000000000000000",                                      // value
                    "from": "0x7a250d5630b4cf539739df2c5dacb4c659f2488d",               // from
                    "to": "0xd695dc9f79cf0b0f8c23e7f01aec354403747a3f"                  // to
                },
                {
                    "index": 2,
                    "token_id": "0x902b2a515c43256158fde75f7de6f155e4a45c14",
                    "type": "",
                    "value": "344876432180959503648615581383",
                    "from": "0xd695dc9f79cf0b0f8c23e7f01aec354403747a3f",
                    "to": "0x3c98189b52fb2e1da681026d4f965ea4f2b7b13c"
                }
            ],
            "metadata": []
        }
        ],
        "nextkey": "",
    },
    "message": "OK"
}

Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/eth/v1/token/txs?token_id=0xc778417e063141139fce010982780140aa0cd5ab'
Example Response
200 OK


{
    "code": 0,
    "data": {
        "items": [
        {
            "id": "0x3a5c680b49451775b67ad9b4846e553c5bd12fbd9e0d77dafd184b3a023e2b1b",
            "type": "token_transfer",                                          
            "gas_limit": 139979,                                              
            "gas_price": "1000000000",                                         
            "gas_used": 102040,                                                
            "nonce": 31,                                                       
            "from": "0x3c98189b52fb2e1da681026d4f965ea4f2b7b13c",               
            "to": "0x7a250d5630b4cf539739df2c5dacb4c659f2488d",                
            "fee": "102040000000000",                                          
            "date": 1620730114,                                                
            "block": 10213589,                                                 
            "confirmation": 2427,                                               
            "status": "completed",                                             
            "token_transfers": [                                               
                {
                    "index": 1,         
                    "token_id": "0xc778417e063141139fce010982780140aa0cd5ab",   
                    "type": "",
                    "value": "100000000000000000",                             
                    "from": "0x7a250d5630b4cf539739df2c5dacb4c659f2488d",
                    "to": "0xd695dc9f79cf0b0f8c23e7f01aec354403747a3f"
                },
                {
                    "index": 2,
                    "token_id": "0x902b2a515c43256158fde75f7de6f155e4a45c14",
                    "type": "",
                    "value": "344876432180959503648615581383",
                    "from": "0xd695dc9f79cf0b0f8c23e7f01aec354403747a3f",
                    "to": "0x3c98189b52fb2e1da681026d4f965ea4f2b7b13c"
                }
            ],
            "metadata": []
        }
        ],
        "nextkey": "",
    },
    "message": "OK"
}

# GET Acquire Token Stat Info of Addresses

/{coin}/v1/token/info

Supported coin: ETH, ETC, BNB, HT, TRX

params type required note
address string yes address to be inquired

Returned info format as follows:



{
    "code": 0,
    "data": [
        "address": "0xdb248d1ab299e2f453eb06d5ef5b1db531996cb1", // address
        "coin": "eth",                                           // coin
        "name": "Qkika Token",                                   // token name
        "symbol": "Qkika",                                       // token ticker
        "decimals": 6,                                           // token decimal
        "token_id": "0xf4beccb8440cfebbbd8a324623c1b2cce9b55ad6",// token id (contract add)
        "balance": "1.238",                                      // balance
        "total_txs": 6,                                          // tx count
    ],
    "message": "OK"
}


Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/eth/v1/token/info?address=0xdb248d1ab299e2f453eb06d5ef5b1db531996cb1'
Example Response
200 OK


{
    "code": 0,
    "data": [
        "address": "0xdb248d1ab299e2f453eb06d5ef5b1db531996cb1", 
        "coin": "eth",                                          
        "name": "Qkika Token",                                 
        "symbol": "Qkika",                                     
        "decimals": 6,                                          
        "token_id": "0xf4beccb8440cfebbbd8a324623c1b2cce9b55ad6",
        "balance": "1.238",                                     
        "total_txs": 6,                                       
    ],
    "message": "OK"
}


# GET Acquire Token Stat Info of Addresses

/{coin}/v1/token/info

Supported coin: ETH, ETC, BNB, HT, TRX

params type required note
address string yes address to be inquired

Returned info format as follows:



{
    "code": 0,
    "data": [
        "address": "0xdb248d1ab299e2f453eb06d5ef5b1db531996cb1", // address
        "coin": "eth",                                           // coin
        "name": "Qkika Token",                                   // token name
        "symbol": "Qkika",                                       // token ticker
        "decimals": 6,                                           // token decimal
        "token_id": "0xf4beccb8440cfebbbd8a324623c1b2cce9b55ad6",// token id (contract add)
        "balance": "1.238",                                      // balance
        "total_txs": 6,                                          // tx count
    ],
    "message": "OK"
}


Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/eth/v1/token/info?address=0xdb248d1ab299e2f453eb06d5ef5b1db531996cb1'
Example Response
200 OK


{
    "code": 0,
    "data": [
        "address": "0xdb248d1ab299e2f453eb06d5ef5b1db531996cb1", 
        "coin": "eth",                                          
        "name": "Qkika Token",                                 
        "symbol": "Qkika",                                     
        "decimals": 6,                                          
        "token_id": "0xf4beccb8440cfebbbd8a324623c1b2cce9b55ad6",
        "balance": "1.238",                                     
        "total_txs": 6,                                       
    ],
    "message": "OK"
}


# POST Transaction info of Initialized Address

/{coin}/v1/address/init

The interface of ETH and similar coins returns 6 months of historical transaction data by default. Use this interface to get complete transaction data of an address.

Supported currencies: ETH, ETC, BNB, HT, TRX

Supported packages: Enterprise Edition

params type required note
address string yes Address to be initialized
Example Request
curl --location --request POST 'https://developers.viawallet.com/openapi/api/eth/v1/init/address?address=0x7db6e6639df365366187c59b49749d1779fe24bc'
Example Response
200 OK

{
    "code": 0,
    "data": {},
    "message": "OK"
}

# POST Transaction info of Initialized Address

/{coin}/v1/address/init

The interface of ETH and similar coins returns 6 months of historical transaction data by default. Use this interface to get complete transaction data of an address.

Supported currencies: ETH, ETC, BNB, HT, TRX

Supported packages: Enterprise Edition

params type required note
address string yes Address to be initialized
Example Request
curl --location --request POST 'https://developers.viawallet.com/openapi/api/eth/v1/init/address?address=0x7db6e6639df365366187c59b49749d1779fe24bc'
Example Response
200 OK

{
    "code": 0,
    "data": {},
    "message": "OK"
}

# ATOM and Other Similar Coins

# GET Inquire Public Chain Basic Info

/{coin}/v1/chain/info

Obtain basic info of public chain via its abbreviations, such as block height, tx count, total circulating supply of native coins, network size etc. Respond format as follows:

{
    "symbol": "ATOM",                                                           // coin/token ticker
    "name": "Cosmos",                                                           // coin/token full name
    "decimals": 6,                                                              // decimal
    "block_time": 10000,                                                        // block time
    "sample_address": "cosmos1evzzwgazyq9m74k94ujlgclkc4nyumed3u7nf3",          // sample address
    "height": 6680785,                                                          // current block height
    "hash": "7296473A849A1BCA00A86BD59D5DA449A8E65227D341F8172194CF67DD4F32F9", // current block hash
    "size": 70390928311,                                                        // chain size, the current field may not be returned
    "tota_txs": 29045598,                                                       // total transactions, the current field may not be returned
    "circulation":16923962                                                      // network circulation, the current field may not be returned
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/atom/v1/chain/info'
Example Response
200 OK
{
    "code": 0,
    "data": {
        "symbol": "ATOM",
        "name": "Cosmos",
        "decimals": 6,
        "block_time": 10000,
        "sample_address": "cosmos1evzzwgazyq9m74k94ujlgclkc4nyumed3u7nf3",
        "height": 6680785,
        "hash": "7296473A849A1BCA00A86BD59D5DA449A8E65227D341F8172194CF67DD4F32F9"
    },
    "message": "OK"
}

# ATOM and Other Similar Coins

# GET Inquire Public Chain Basic Info

/{coin}/v1/chain/info

Obtain basic info of public chain via its abbreviations, such as block height, tx count, total circulating supply of native coins, network size etc. Respond format as follows:

{
    "symbol": "ATOM",                                                           // coin/token ticker
    "name": "Cosmos",                                                           // coin/token full name
    "decimals": 6,                                                              // decimal
    "block_time": 10000,                                                        // block time
    "sample_address": "cosmos1evzzwgazyq9m74k94ujlgclkc4nyumed3u7nf3",          // sample address
    "height": 6680785,                                                          // current block height
    "hash": "7296473A849A1BCA00A86BD59D5DA449A8E65227D341F8172194CF67DD4F32F9", // current block hash
    "size": 70390928311,                                                        // chain size, the current field may not be returned
    "tota_txs": 29045598,                                                       // total transactions, the current field may not be returned
    "circulation":16923962                                                      // network circulation, the current field may not be returned
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/atom/v1/chain/info'
Example Response
200 OK
{
    "code": 0,
    "data": {
        "symbol": "ATOM",
        "name": "Cosmos",
        "decimals": 6,
        "block_time": 10000,
        "sample_address": "cosmos1evzzwgazyq9m74k94ujlgclkc4nyumed3u7nf3",
        "height": 6680785,
        "hash": "7296473A849A1BCA00A86BD59D5DA449A8E65227D341F8172194CF67DD4F32F9"
    },
    "message": "OK"
}

# GET Acquire Block Info

/{coin}/v1/block

Acquire block information based on block height or hash

params type required note
hashOrHeight string yes block hash or height

Return format as follows:

{
    "code": 0,
    "data": {
        "date": 1624416166,                                                                 // timestamp
        "height": 6680786,                                                                  // block height
        "hash": "3962C5424CFEEDFC1D217213009F09B56C44E6DF60117618AD5F2B2AC4FA69EE",         // block hash
        "confirmations": 20,                                                                // number of confirmation
        "txs": [                                                                            // tx list
            "A45D5CD68573668BD173AA0A0911BBD934BA7892ED1CF714432B0956915F7DB9"              // txid
        ],
        "parent_hash": "7296473A849A1BCA00A86BD59D5DA449A8E65227D341F8172194CF67DD4F32F9",  // hash of the previous block
    },
    "message": "OK"
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/atom/v1/block?hashOrHeight=6680786'

Example Response
200 OK
{
    "code": 0,
    "data": {
        "date": 1624416166,
        "height": 6680786,
        "hash": "3962C5424CFEEDFC1D217213009F09B56C44E6DF60117618AD5F2B2AC4FA69EE",
        "confirmations": 26,
        "txs": [
            "A45D5CD68573668BD173AA0A0911BBD934BA7892ED1CF714432B0956915F7DB9"
        ],
        "parent_hash": "7296473A849A1BCA00A86BD59D5DA449A8E65227D341F8172194CF67DD4F32F9"
    },
    "message": "OK"
}

# GET Acquire Block Info

/{coin}/v1/block

Acquire block information based on block height or hash

params type required note
hashOrHeight string yes block hash or height

Return format as follows:

{
    "code": 0,
    "data": {
        "date": 1624416166,                                                                 // timestamp
        "height": 6680786,                                                                  // block height
        "hash": "3962C5424CFEEDFC1D217213009F09B56C44E6DF60117618AD5F2B2AC4FA69EE",         // block hash
        "confirmations": 20,                                                                // number of confirmation
        "txs": [                                                                            // tx list
            "A45D5CD68573668BD173AA0A0911BBD934BA7892ED1CF714432B0956915F7DB9"              // txid
        ],
        "parent_hash": "7296473A849A1BCA00A86BD59D5DA449A8E65227D341F8172194CF67DD4F32F9",  // hash of the previous block
    },
    "message": "OK"
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/atom/v1/block?hashOrHeight=6680786'

Example Response
200 OK
{
    "code": 0,
    "data": {
        "date": 1624416166,
        "height": 6680786,
        "hash": "3962C5424CFEEDFC1D217213009F09B56C44E6DF60117618AD5F2B2AC4FA69EE",
        "confirmations": 26,
        "txs": [
            "A45D5CD68573668BD173AA0A0911BBD934BA7892ED1CF714432B0956915F7DB9"
        ],
        "parent_hash": "7296473A849A1BCA00A86BD59D5DA449A8E65227D341F8172194CF67DD4F32F9"
    },
    "message": "OK"
}

# GET Acquire Address Detailed Info

/{coin}/v1/address/info

Acquire address info via public chain abbreviation and address, including: Balance, balance ranking, tx count, transfer count, reception count and the details of last tx

params type required note
address string yes address to be inquired

The return format is as follows:

{
    "code": 0,
    "data": {
        "address": "cosmos1hrypv8su9d9jn70ywqvmprcf69xwjkv85c9fgq", // address
        "start_height": 5201130,                                    // initial height since info inquiry
        "start_time": 1624416793,                                   // initial time since info inquiry
        "height": 6680892,                                          // final height at the end of info inquiry
        "balance": "0.028",                                         // address balance
        "available": "0.028",                                       // balance available
        "delegated": "0",                                           // delegated amount
        "unbonding": "0",                                           // withdrawn reward
        "reward": "0",                                              // to-be-withdrawn reward
        "total_txs": 1,                                             // total tx count
        "total_tx_in": "0",                                         // received amount
        "total_tx_out": "9.87",                                     // transferred amount
        "latest_tx": {                                              // last tx
            "id": "91368C9107F0E9205623C91F9E100D564A0DFB5BFFC29E9278785B8E42E460AF",
            "type": "transfer",
            "gas_limit": 80000,
            "gas_used": 68201,
            "fee": "0.002",
            "date": 1613654322,
            "value": "0",
            "block": 5201130,
            "confirmation": 0,
            "status": "completed",
            "metadata": [
                {
                    "from": "cosmos1hrypv8su9d9jn70ywqvmprcf69xwjkv85c9fgq",
                    "index": 0,
                    "to": "cosmos1j6nxmeankzm8jnzvwevtypamzkgnec25kvcxpz",
                    "type": "cosmos-sdk/MsgSend",
                    "value": "9.87"
                }
            ]
        }
    },
    "message": "OK"
}
Example Request
curl --localtion --request GET 'https://developers.viawallet.com/openapi/api/atom/v1/address/info?address=cosmos1hrypv8su9d9jn70ywqvmprcf69xwjkv85c9fgq'
Example Response
200 OK

# GET Acquire Address Detailed Info

/{coin}/v1/address/info

Acquire address info via public chain abbreviation and address, including: Balance, balance ranking, tx count, transfer count, reception count and the details of last tx

params type required note
address string yes address to be inquired

The return format is as follows:

{
    "code": 0,
    "data": {
        "address": "cosmos1hrypv8su9d9jn70ywqvmprcf69xwjkv85c9fgq", // address
        "start_height": 5201130,                                    // initial height since info inquiry
        "start_time": 1624416793,                                   // initial time since info inquiry
        "height": 6680892,                                          // final height at the end of info inquiry
        "balance": "0.028",                                         // address balance
        "available": "0.028",                                       // balance available
        "delegated": "0",                                           // delegated amount
        "unbonding": "0",                                           // withdrawn reward
        "reward": "0",                                              // to-be-withdrawn reward
        "total_txs": 1,                                             // total tx count
        "total_tx_in": "0",                                         // received amount
        "total_tx_out": "9.87",                                     // transferred amount
        "latest_tx": {                                              // last tx
            "id": "91368C9107F0E9205623C91F9E100D564A0DFB5BFFC29E9278785B8E42E460AF",
            "type": "transfer",
            "gas_limit": 80000,
            "gas_used": 68201,
            "fee": "0.002",
            "date": 1613654322,
            "value": "0",
            "block": 5201130,
            "confirmation": 0,
            "status": "completed",
            "metadata": [
                {
                    "from": "cosmos1hrypv8su9d9jn70ywqvmprcf69xwjkv85c9fgq",
                    "index": 0,
                    "to": "cosmos1j6nxmeankzm8jnzvwevtypamzkgnec25kvcxpz",
                    "type": "cosmos-sdk/MsgSend",
                    "value": "9.87"
                }
            ]
        }
    },
    "message": "OK"
}
Example Request
curl --localtion --request GET 'https://developers.viawallet.com/openapi/api/atom/v1/address/info?address=cosmos1hrypv8su9d9jn70ywqvmprcf69xwjkv85c9fgq'
Example Response
200 OK

# GET Acquire Transaction List of the Address

/{coin}/v1/address/txs

Acquire tx list of the address via public chain abbreviation and block height

params type required note
address string yes address to be acquired
nextkey string no query cursor

The return format is as follows:

{
    "code": 0,
    "data": {
        "items": [
            {
                "id": "D3300DE48F6E16A2670EFF89EA60DC584577E6F7E5C3BBD1DDA83651D801AD0A", // tx hash
                "type": "any_action",                                                     // tx type, normal transfer: transfer; other tx: any_action
                "gas_limit": 339022,                                                      // gas limit
                "gas_used": 308189,                                                       // gas used
                "fee": "0.016952",                                                        // tx fees
                "date": 1624419837,
                "value": "0",                                                             // transferred amount
                "block": 6681286,                                                         // block height
                "confirmation": 1,                                                        // number of confirmation
                "status": "completed",                                                    // tx status
                "message": "{\"@type\":\"/ibc.core.client.v1.MsgUpdateClient\"...",       // other tx data expect for normal transfer
                "metadata": [
                    {
                        "from": "cosmos1zz22dfpvw3zqpeyhvhmx944a588fgcalw744ts",          // tx initiated address
                        "index": 0,                                                       // packed order
                        "to": "",                                                         // target address
                        "type": "cosmos-sdk/MsgUpdateClient",                             // tx type
                        "value": ""                                                       // value
                    }, 
                    {
                        "from": "cosmos1zz22dfpvw3zqpeyhvhmx944a588fgcalw744ts",
                        "index": 1,
                        "to": "",
                        "type": "cosmos-sdk/MsgRecvPacket",
                        "value": ""
                    }
                ]
            }
        ],
        "nextkey": "Fqy6VccmFWYoWXe7Rppwey"
    },
    "message": "OK"
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/atom/v1/txs?address=cosmos1zz22dfpvw3zqpeyhvhmx944a588fgcalw744ts'

Example Response
200 OK
{
    "code": 0,
    "data": {
        "items": [
            {
                "id": "D3300DE48F6E16A2670EFF89EA60DC584577E6F7E5C3BBD1DDA83651D801AD0A",
                "type": "any_action",
                "gas_limit": 339022,
                "gas_used": 308189,
                "fee": "0.016952",
                "date": 1624419837,
                "value": "0",
                "block": 6681286,
                "confirmation": 1,
                "status": "completed",
                "message": "{\"@type\":\"/ibc.core.client.v1.MsgUpdateClient\",\"client_id\":\"07-tendermint-259\",\"header\":{\"@type\":\"/ibc.lightclients.tendermint.v1.Header\",\"signed_header\":{\"header\":{\"version\":{\"block\":\"11\",\"app\":\"1\"},\"chain_id\":\"osmosis-1\",\"height\":\"58324\",\"time\":\"2021-06-23T03:43:49.850331239Z\",\"last_block_id\":{\"hash\":\"5V5E93aWijza+ARUOt5qyZXbLQwLaD/9vPkV/WUmfKg=\",\"part_set_header\":{\"total\":1,\"hash\":\"l2xGKw6VPqRjFvk4FVkhTWfymrMFgTku5cjiHD0FS2s=\"}},...",
                "metadata": [
                    {
                        "from": "cosmos1zz22dfpvw3zqpeyhvhmx944a588fgcalw744ts",
                        "index": 0,
                        "to": "",
                        "type": "cosmos-sdk/MsgUpdateClient",
                        "value": ""
                    },
                    {
                        "from": "cosmos1zz22dfpvw3zqpeyhvhmx944a588fgcalw744ts",
                        "index": 1,
                        "to": "",
                        "type": "cosmos-sdk/MsgRecvPacket",
                        "value": ""
                    }
                ]
            }
        ],
        "nextkey": "Fqy6VccmFWYoWXe7Rppwey"
    },
    "message": "OK"
}

# GET Acquire Transaction List of the Address

/{coin}/v1/address/txs

Acquire tx list of the address via public chain abbreviation and block height

params type required note
address string yes address to be acquired
nextkey string no query cursor

The return format is as follows:

{
    "code": 0,
    "data": {
        "items": [
            {
                "id": "D3300DE48F6E16A2670EFF89EA60DC584577E6F7E5C3BBD1DDA83651D801AD0A", // tx hash
                "type": "any_action",                                                     // tx type, normal transfer: transfer; other tx: any_action
                "gas_limit": 339022,                                                      // gas limit
                "gas_used": 308189,                                                       // gas used
                "fee": "0.016952",                                                        // tx fees
                "date": 1624419837,
                "value": "0",                                                             // transferred amount
                "block": 6681286,                                                         // block height
                "confirmation": 1,                                                        // number of confirmation
                "status": "completed",                                                    // tx status
                "message": "{\"@type\":\"/ibc.core.client.v1.MsgUpdateClient\"...",       // other tx data expect for normal transfer
                "metadata": [
                    {
                        "from": "cosmos1zz22dfpvw3zqpeyhvhmx944a588fgcalw744ts",          // tx initiated address
                        "index": 0,                                                       // packed order
                        "to": "",                                                         // target address
                        "type": "cosmos-sdk/MsgUpdateClient",                             // tx type
                        "value": ""                                                       // value
                    }, 
                    {
                        "from": "cosmos1zz22dfpvw3zqpeyhvhmx944a588fgcalw744ts",
                        "index": 1,
                        "to": "",
                        "type": "cosmos-sdk/MsgRecvPacket",
                        "value": ""
                    }
                ]
            }
        ],
        "nextkey": "Fqy6VccmFWYoWXe7Rppwey"
    },
    "message": "OK"
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/atom/v1/txs?address=cosmos1zz22dfpvw3zqpeyhvhmx944a588fgcalw744ts'

Example Response
200 OK
{
    "code": 0,
    "data": {
        "items": [
            {
                "id": "D3300DE48F6E16A2670EFF89EA60DC584577E6F7E5C3BBD1DDA83651D801AD0A",
                "type": "any_action",
                "gas_limit": 339022,
                "gas_used": 308189,
                "fee": "0.016952",
                "date": 1624419837,
                "value": "0",
                "block": 6681286,
                "confirmation": 1,
                "status": "completed",
                "message": "{\"@type\":\"/ibc.core.client.v1.MsgUpdateClient\",\"client_id\":\"07-tendermint-259\",\"header\":{\"@type\":\"/ibc.lightclients.tendermint.v1.Header\",\"signed_header\":{\"header\":{\"version\":{\"block\":\"11\",\"app\":\"1\"},\"chain_id\":\"osmosis-1\",\"height\":\"58324\",\"time\":\"2021-06-23T03:43:49.850331239Z\",\"last_block_id\":{\"hash\":\"5V5E93aWijza+ARUOt5qyZXbLQwLaD/9vPkV/WUmfKg=\",\"part_set_header\":{\"total\":1,\"hash\":\"l2xGKw6VPqRjFvk4FVkhTWfymrMFgTku5cjiHD0FS2s=\"}},...",
                "metadata": [
                    {
                        "from": "cosmos1zz22dfpvw3zqpeyhvhmx944a588fgcalw744ts",
                        "index": 0,
                        "to": "",
                        "type": "cosmos-sdk/MsgUpdateClient",
                        "value": ""
                    },
                    {
                        "from": "cosmos1zz22dfpvw3zqpeyhvhmx944a588fgcalw744ts",
                        "index": 1,
                        "to": "",
                        "type": "cosmos-sdk/MsgRecvPacket",
                        "value": ""
                    }
                ]
            }
        ],
        "nextkey": "Fqy6VccmFWYoWXe7Rppwey"
    },
    "message": "OK"
}

# GET Detail of a Singular Transaction

/{coin}/v1/tx

Acquire tx details via public chain abbreviation and block height

params type required note
tx_id string yes tx hash to be inquired

The return format is as follows:

{
    "code": 0,
    "data": {
        "id": "2487E31D455146291275B6BA9D8147A7C2ADEF30A17F0C8EB16F7DAB1648A970", // tx hash
        "type": "any_action",                                                     // tx type
        "gas_limit": 325806,                                                      // gas price
        "gas_used": 296187,                                                       // gas used
        "fee": "0.016291",                                                        // tx fees
        "date": 1624413396,                                                       // date
        "value": "0",                                                             // value
        "block": 6680409,                                                         // block height
        "confirmation": 2095,                                                     // number of confirmation
        "status": "completed",                                                    // status
        "message": "{\"@type\":\"/ibc.core.client.v1.MsgUpdateClient\",\"client_id\":\"07-tendermint-259\",\"header\":{\"@type\":\"/ibc.lightclients.tendermint.v1.Header\"...",       // tx data
        "metadata": [                                                    // tx info
            {
                "from": "cosmos1zz22dfpvw3zqpeyhvhmx944a588fgcalw744ts", // tx initiated address
                "index": 0,                                              // packed order
                "to": "",                                                // target address
                "type": "cosmos-sdk/MsgUpdateClient",                    // tx type
                "value": ""                                              // value
            }, 
            {
                "from": "cosmos1zz22dfpvw3zqpeyhvhmx944a588fgcalw744ts",
                "index": 1,
                "to": "",
                "type": "cosmos-sdk/MsgRecvPacket",
                "value": ""
            }
        ]
    },
    "message": "OK"
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/atom/v1/tx?tx_id=2487E31D455146291275B6BA9D8147A7C2ADEF30A17F0C8EB16F7DAB1648A970'

Example Response
200 OK

{
    "code": 0,
    "data": {
        "id": "0x8a23c23a7813843bb7bf16fc51e822832cb4168f99658d7c6ed21a13d1db1622",
        "gas_limit": 21000,
        "gas_price": "100000000000",
        "gas_used": 21000,
        "nonce": 2619,
        "from": "0xc5fade3198fe1f8bed3ec25b3d68bf9a8ddf934f",
        "to": "0xeb547a7354e6fe0da3bae56c1efe9a76ac5a7519",
        "fee": "2100000000000000",
        "date": 1620532384,
        "block": 10200000,
        "confirmation": 16016,
        "status": "completed",
        "metadata": []
    },
    "message": "OK"
}

# GET Detail of a Singular Transaction

/{coin}/v1/tx

Acquire tx details via public chain abbreviation and block height

params type required note
tx_id string yes tx hash to be inquired

The return format is as follows:

{
    "code": 0,
    "data": {
        "id": "2487E31D455146291275B6BA9D8147A7C2ADEF30A17F0C8EB16F7DAB1648A970", // tx hash
        "type": "any_action",                                                     // tx type
        "gas_limit": 325806,                                                      // gas price
        "gas_used": 296187,                                                       // gas used
        "fee": "0.016291",                                                        // tx fees
        "date": 1624413396,                                                       // date
        "value": "0",                                                             // value
        "block": 6680409,                                                         // block height
        "confirmation": 2095,                                                     // number of confirmation
        "status": "completed",                                                    // status
        "message": "{\"@type\":\"/ibc.core.client.v1.MsgUpdateClient\",\"client_id\":\"07-tendermint-259\",\"header\":{\"@type\":\"/ibc.lightclients.tendermint.v1.Header\"...",       // tx data
        "metadata": [                                                    // tx info
            {
                "from": "cosmos1zz22dfpvw3zqpeyhvhmx944a588fgcalw744ts", // tx initiated address
                "index": 0,                                              // packed order
                "to": "",                                                // target address
                "type": "cosmos-sdk/MsgUpdateClient",                    // tx type
                "value": ""                                              // value
            }, 
            {
                "from": "cosmos1zz22dfpvw3zqpeyhvhmx944a588fgcalw744ts",
                "index": 1,
                "to": "",
                "type": "cosmos-sdk/MsgRecvPacket",
                "value": ""
            }
        ]
    },
    "message": "OK"
}
Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/atom/v1/tx?tx_id=2487E31D455146291275B6BA9D8147A7C2ADEF30A17F0C8EB16F7DAB1648A970'

Example Response
200 OK

{
    "code": 0,
    "data": {
        "id": "0x8a23c23a7813843bb7bf16fc51e822832cb4168f99658d7c6ed21a13d1db1622",
        "gas_limit": 21000,
        "gas_price": "100000000000",
        "gas_used": 21000,
        "nonce": 2619,
        "from": "0xc5fade3198fe1f8bed3ec25b3d68bf9a8ddf934f",
        "to": "0xeb547a7354e6fe0da3bae56c1efe9a76ac5a7519",
        "fee": "2100000000000000",
        "date": 1620532384,
        "block": 10200000,
        "confirmation": 16016,
        "status": "completed",
        "metadata": []
    },
    "message": "OK"
}

# GET Number of Confirmation For a Singular Transaction

/{coin}/v1/tx/confirmation

Acquire the number of confirmation for the tx via public chain abbreviation and block height

params type required note
tx_id string yes tx hash to be inquired

The return format is as follows:

{
    "code":0,
    "message":"OK",
    "data":{
        "confirmation": 1478145,                                                      // number of confirmation
        "platform": "ATOM",                                                           // coin/token
        "tx_id": "B831EEF5C4C56979D16666E79985746A73595075546ABB9178320DC7A5B39448"   // txid
    }
}

Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/atom/v1/tx/confirmation?tx_id=B831EEF5C4C56979D16666E79985746A73595075546ABB9178320DC7A5B39448
'
Example Response
200 OK

{
    "code": 0,
    "data": {
        "confirmation": 1478145,
        "platform": "atom",
        "tx_id": "B831EEF5C4C56979D16666E79985746A73595075546ABB9178320DC7A5B39448"
    },
    "message": "OK"
}

# GET Number of Confirmation For a Singular Transaction

/{coin}/v1/tx/confirmation

Acquire the number of confirmation for the tx via public chain abbreviation and block height

params type required note
tx_id string yes tx hash to be inquired

The return format is as follows:

{
    "code":0,
    "message":"OK",
    "data":{
        "confirmation": 1478145,                                                      // number of confirmation
        "platform": "ATOM",                                                           // coin/token
        "tx_id": "B831EEF5C4C56979D16666E79985746A73595075546ABB9178320DC7A5B39448"   // txid
    }
}

Example Request
curl --location --request GET 'https://developers.viawallet.com/openapi/api/atom/v1/tx/confirmation?tx_id=B831EEF5C4C56979D16666E79985746A73595075546ABB9178320DC7A5B39448
'
Example Response
200 OK

{
    "code": 0,
    "data": {
        "confirmation": 1478145,
        "platform": "atom",
        "tx_id": "B831EEF5C4C56979D16666E79985746A73595075546ABB9178320DC7A5B39448"
    },
    "message": "OK"
}

# GET Acquire Transaction List of the Block

/{coin}/v1/block/txs

Acquire tx list at this block height via public chain abbreviation and block height

params type required note
height int64 yes block height
nextkey string no query cursor

The return format is as follows:


{
    "code": 0,
    "data": {
        "items": [
            {
                "id": "B831EEF5C4C56979D16666E79985746A73595075546ABB9178320DC7A5B39448", // tx hash
                "type": "any_action",                                                     // tx type
                "gas_limit": 231495,                                                      // gas limit
                "gas_used": 231584,                                                       // gas price
                "memo": "delegation via citadel.one",                                     // memo
                "fee": "0.003472",                                                        // tx fees
                "date": 1613679473,                                                       // date
                "value": "0",                                                             // value
                "block": 5204455,                                                         // block height
                "confirmation": 1478174,                                                  // number of confirmation
                "status": "error",                                                        // tx status
                "metadata": [                                                             // tx info
                    {
                        "from": "cosmos12gha4nyydysttfmdkup73txavg0fsfpc50rk5a",          // tx initiated address
                        "index": 0,                                                       // packed order
                        "source_validator_addr": "cosmosvaloper146kwpzhmleafmhtaxulfptyhnvwxzlvm87hwnm", // source validator address
                        "to": "cosmosvaloper1e859xaue4k2jzqw20cv6l7p3tmc378pc3k8g2u",     // validator address
                        "type": "cosmos-sdk/MsgBeginRedelegate",                          // tx type
                        "value": "0.01"                                                   // value
                    },
                    {
                        "from": "cosmos12gha4nyydysttfmdkup73txavg0fsfpc50rk5a",          // tx initiated address
                        "index": 1,                                                       // packed order
                        "to": "cosmosvaloper1e859xaue4k2jzqw20cv6l7p3tmc378pc3k8g2u",     // target address
                        "type": "cosmos-sdk/MsgDelegate",                                 // tx type
                        "value": "0.09"                                                   // value
                    }
                ]
            },
            {
                "id": "B13E156EFD9A9230330D3F5CE72ABD38767774EA3B3BA095A7210C4489A967F0",
                "type": "any_action",
                "gas_limit": 203000,
                "gas_used": 146450,
                "memo": "Delegated with Exodus",
                "fee": "0.005075",
                "date": 1613679473,
                "value": "0",
                "block": 5204455,
                "confirmation": 1478174,
                "status": "completed",
                "metadata": [
                    {
                        "from": "cosmos1qly2e2psnsf0aljxj4mw3rxdtcznrzr6jwv02a",
                        "index": 0,
                        "to": "cosmosvaloper1tflk30mq5vgqjdly92kkhhq3raev2hnz6eete3",
                        "type": "cosmos-sdk/MsgDelegate",
                        "value": "2"
                    }
                ]
            }
        ],
        "nextkey": "7keGg7JB3FNZ1R"
    },
    "message": "OK"
}

Example Request
curl --location --request GET 'http://developers.viawallet.com/openapi/api/atom/v1/block/txs?height=5204455' \
--header 'X-API-Key: BRfvZY97QaRa14Ci1F5vvP3KzwRxFFMw'
Example Response
200 OK

{
    "code": 0,
    "data": {
        "items": [
            {
                "id": "B831EEF5C4C56979D16666E79985746A73595075546ABB9178320DC7A5B39448",
                "type": "any_action",
                "gas_limit": 231495,
                "gas_used": 231584,
                "memo": "delegation via citadel.one",
                "fee": "0.003472",
                "date": 1613679473,
                "value": "0",
                "block": 5204455,
                "confirmation": 1478174,
                "status": "error",
                "metadata": [
                    {
                        "from": "cosmos12gha4nyydysttfmdkup73txavg0fsfpc50rk5a",
                        "index": 0,
                        "source_validator_addr": "cosmosvaloper146kwpzhmleafmhtaxulfptyhnvwxzlvm87hwnm",
                        "to": "cosmosvaloper1e859xaue4k2jzqw20cv6l7p3tmc378pc3k8g2u",
                        "type": "cosmos-sdk/MsgBeginRedelegate",
                        "value": "0.01"
                    },
                    {
                        "from": "cosmos12gha4nyydysttfmdkup73txavg0fsfpc50rk5a",
                        "index": 1,
                        "to": "cosmosvaloper1e859xaue4k2jzqw20cv6l7p3tmc378pc3k8g2u",
                        "type": "cosmos-sdk/MsgDelegate",
                        "value": "0.09"
                    }
                ]
            },
            {
                "id": "B13E156EFD9A9230330D3F5CE72ABD38767774EA3B3BA095A7210C4489A967F0",
                "type": "any_action",
                "gas_limit": 203000,
                "gas_used": 146450,
                "memo": "Delegated with Exodus",
                "fee": "0.005075",
                "date": 1613679473,
                "value": "0",
                "block": 5204455,
                "confirmation": 1478174,
                "status": "completed",
                "metadata": [
                    {
                        "from": "cosmos1qly2e2psnsf0aljxj4mw3rxdtcznrzr6jwv02a",
                        "index": 0,
                        "to": "cosmosvaloper1tflk30mq5vgqjdly92kkhhq3raev2hnz6eete3",
                        "type": "cosmos-sdk/MsgDelegate",
                        "value": "2"
                    }
                ]
            }
        ],
        "nextkey": "7keGg7JB3FNZ1R"
    },
    "message": "OK"
}

# GET Acquire Transaction List of the Block

/{coin}/v1/block/txs

Acquire tx list at this block height via public chain abbreviation and block height

params type required note
height int64 yes block height
nextkey string no query cursor

The return format is as follows:


{
    "code": 0,
    "data": {
        "items": [
            {
                "id": "B831EEF5C4C56979D16666E79985746A73595075546ABB9178320DC7A5B39448", // tx hash
                "type": "any_action",                                                     // tx type
                "gas_limit": 231495,                                                      // gas limit
                "gas_used": 231584,                                                       // gas price
                "memo": "delegation via citadel.one",                                     // memo
                "fee": "0.003472",                                                        // tx fees
                "date": 1613679473,                                                       // date
                "value": "0",                                                             // value
                "block": 5204455,                                                         // block height
                "confirmation": 1478174,                                                  // number of confirmation
                "status": "error",                                                        // tx status
                "metadata": [                                                             // tx info
                    {
                        "from": "cosmos12gha4nyydysttfmdkup73txavg0fsfpc50rk5a",          // tx initiated address
                        "index": 0,                                                       // packed order
                        "source_validator_addr": "cosmosvaloper146kwpzhmleafmhtaxulfptyhnvwxzlvm87hwnm", // source validator address
                        "to": "cosmosvaloper1e859xaue4k2jzqw20cv6l7p3tmc378pc3k8g2u",     // validator address
                        "type": "cosmos-sdk/MsgBeginRedelegate",                          // tx type
                        "value": "0.01"                                                   // value
                    },
                    {
                        "from": "cosmos12gha4nyydysttfmdkup73txavg0fsfpc50rk5a",          // tx initiated address
                        "index": 1,                                                       // packed order
                        "to": "cosmosvaloper1e859xaue4k2jzqw20cv6l7p3tmc378pc3k8g2u",     // target address
                        "type": "cosmos-sdk/MsgDelegate",                                 // tx type
                        "value": "0.09"                                                   // value
                    }
                ]
            },
            {
                "id": "B13E156EFD9A9230330D3F5CE72ABD38767774EA3B3BA095A7210C4489A967F0",
                "type": "any_action",
                "gas_limit": 203000,
                "gas_used": 146450,
                "memo": "Delegated with Exodus",
                "fee": "0.005075",
                "date": 1613679473,
                "value": "0",
                "block": 5204455,
                "confirmation": 1478174,
                "status": "completed",
                "metadata": [
                    {
                        "from": "cosmos1qly2e2psnsf0aljxj4mw3rxdtcznrzr6jwv02a",
                        "index": 0,
                        "to": "cosmosvaloper1tflk30mq5vgqjdly92kkhhq3raev2hnz6eete3",
                        "type": "cosmos-sdk/MsgDelegate",
                        "value": "2"
                    }
                ]
            }
        ],
        "nextkey": "7keGg7JB3FNZ1R"
    },
    "message": "OK"
}

Example Request
curl --location --request GET 'http://developers.viawallet.com/openapi/api/atom/v1/block/txs?height=5204455' \
--header 'X-API-Key: BRfvZY97QaRa14Ci1F5vvP3KzwRxFFMw'
Example Response
200 OK

{
    "code": 0,
    "data": {
        "items": [
            {
                "id": "B831EEF5C4C56979D16666E79985746A73595075546ABB9178320DC7A5B39448",
                "type": "any_action",
                "gas_limit": 231495,
                "gas_used": 231584,
                "memo": "delegation via citadel.one",
                "fee": "0.003472",
                "date": 1613679473,
                "value": "0",
                "block": 5204455,
                "confirmation": 1478174,
                "status": "error",
                "metadata": [
                    {
                        "from": "cosmos12gha4nyydysttfmdkup73txavg0fsfpc50rk5a",
                        "index": 0,
                        "source_validator_addr": "cosmosvaloper146kwpzhmleafmhtaxulfptyhnvwxzlvm87hwnm",
                        "to": "cosmosvaloper1e859xaue4k2jzqw20cv6l7p3tmc378pc3k8g2u",
                        "type": "cosmos-sdk/MsgBeginRedelegate",
                        "value": "0.01"
                    },
                    {
                        "from": "cosmos12gha4nyydysttfmdkup73txavg0fsfpc50rk5a",
                        "index": 1,
                        "to": "cosmosvaloper1e859xaue4k2jzqw20cv6l7p3tmc378pc3k8g2u",
                        "type": "cosmos-sdk/MsgDelegate",
                        "value": "0.09"
                    }
                ]
            },
            {
                "id": "B13E156EFD9A9230330D3F5CE72ABD38767774EA3B3BA095A7210C4489A967F0",
                "type": "any_action",
                "gas_limit": 203000,
                "gas_used": 146450,
                "memo": "Delegated with Exodus",
                "fee": "0.005075",
                "date": 1613679473,
                "value": "0",
                "block": 5204455,
                "confirmation": 1478174,
                "status": "completed",
                "metadata": [
                    {
                        "from": "cosmos1qly2e2psnsf0aljxj4mw3rxdtcznrzr6jwv02a",
                        "index": 0,
                        "to": "cosmosvaloper1tflk30mq5vgqjdly92kkhhq3raev2hnz6eete3",
                        "type": "cosmos-sdk/MsgDelegate",
                        "value": "2"
                    }
                ]
            }
        ],
        "nextkey": "7keGg7JB3FNZ1R"
    },
    "message": "OK"
}

# GET Acquire Validator Info

/{coin}/v1/validators

Acquire validator info

params type required note
nextkey string no query cursor

The return format is as follows:

{
    "code": 0,
    "data": {
        "items": [
            {
                "validator_address": "cosmosvaloper1wwspfe7whh3zu4ql5rvpg044lyk6cuu7fpnd9e", // validator address
                "validator_name": "Bit Cat🐱",                                               // validator name
                "identity": "FAB46CEEAEAB9FA1",                                              // identity
                "annual_income": "0",                                                        // APY
                "fee": "5",                                                                  // fees
                "jailed": true,                                                              // Jailed or not
                "status": "unbonded",                                                        // node status
                "voting_token": "9999307000000",                                             // number of vote
                "voting_rights": "0",                                                        // voting weight
                "delegations_number": "",                                                    // number of delegations
            },
            {
                "validator_address": "cosmosvaloper1402ggxz5u6vm29sqztwqq8vxs3ke6dmwl2z5dk",
                "validator_name": "Cosmoon",
                "identity": "8935A6F323FA0881",
                "annual_income": "0",
                "fee": "0",
                "jailed": true,
                "status": "unbonded",
                "voting_token": "999911000000",
                "voting_rights": "0",
                "delegations_number": "",
            },
            ...
        ],
        "nextkey": "WodWBjd5iBQDpRc"
    },
    "message": "OK"
}
Example Request
curl --location --request GET 'http://developers.viawallet.com/openapi/api/atom/v1/validators' \
--header 'X-API-Key: BRfvZY97QaRa14Ci1F5vvP3KzwRxFFMw'
Example Response
200 OK
{
    "code": 0,
    "data": {
        "items": [
            {
                "validator_address": "cosmosvaloper1wwspfe7whh3zu4ql5rvpg044lyk6cuu7fpnd9e",
                "validator_name": "Bit Cat🐱",
                "identity": "FAB46CEEAEAB9FA1",
                "annual_income": "0",
                "fee": "5",
                "jailed": true,
                "status": "unbonded",
                "voting_token": "9999307000000",
                "voting_rights": "0",
                "delegations_number": "",
                "logo_url": ""
            },
            {
                "validator_address": "cosmosvaloper1402ggxz5u6vm29sqztwqq8vxs3ke6dmwl2z5dk",
                "validator_name": "Cosmoon",
                "identity": "8935A6F323FA0881",
                "annual_income": "0",
                "fee": "0",
                "jailed": true,
                "status": "unbonded",
                "voting_token": "999911000000",
                "voting_rights": "0",
                "delegations_number": "",
                "logo_url": ""
            },
            {
                "validator_address": "cosmosvaloper1dt4h3hn9zpxvm2t26erf96aaszp3va2wkq28ez",
                "validator_name": "deleteme",
                "identity": "66425D7D043D9840",
                "annual_income": "0",
                "fee": "7",
                "jailed": true,
                "status": "unbonded",
                "voting_token": "999902000000",
                "voting_rights": "0",
                "delegations_number": "",
                "logo_url": ""
            },
            {
                "validator_address": "cosmosvaloper174glllafa668rcr2qzf5m0844ve60h0urf3h6u",
                "validator_name": "ChainPartners",
                "identity": "",
                "annual_income": "0",
                "fee": "3",
                "jailed": true,
                "status": "unbonded",
                "voting_token": "9999002000000",
                "voting_rights": "0",
                "delegations_number": "",
                "logo_url": ""
            }
        ],
        "nextkey": "WodWBjd5iBQDpRc"
    },
    "message": "OK"
}

# GET Acquire Validator Info

/{coin}/v1/validators

Acquire validator info

params type required note
nextkey string no query cursor

The return format is as follows:

{
    "code": 0,
    "data": {
        "items": [
            {
                "validator_address": "cosmosvaloper1wwspfe7whh3zu4ql5rvpg044lyk6cuu7fpnd9e", // validator address
                "validator_name": "Bit Cat🐱",                                               // validator name
                "identity": "FAB46CEEAEAB9FA1",                                              // identity
                "annual_income": "0",                                                        // APY
                "fee": "5",                                                                  // fees
                "jailed": true,                                                              // Jailed or not
                "status": "unbonded",                                                        // node status
                "voting_token": "9999307000000",                                             // number of vote
                "voting_rights": "0",                                                        // voting weight
                "delegations_number": "",                                                    // number of delegations
            },
            {
                "validator_address": "cosmosvaloper1402ggxz5u6vm29sqztwqq8vxs3ke6dmwl2z5dk",
                "validator_name": "Cosmoon",
                "identity": "8935A6F323FA0881",
                "annual_income": "0",
                "fee": "0",
                "jailed": true,
                "status": "unbonded",
                "voting_token": "999911000000",
                "voting_rights": "0",
                "delegations_number": "",
            },
            ...
        ],
        "nextkey": "WodWBjd5iBQDpRc"
    },
    "message": "OK"
}
Example Request
curl --location --request GET 'http://developers.viawallet.com/openapi/api/atom/v1/validators' \
--header 'X-API-Key: BRfvZY97QaRa14Ci1F5vvP3KzwRxFFMw'
Example Response
200 OK
{
    "code": 0,
    "data": {
        "items": [
            {
                "validator_address": "cosmosvaloper1wwspfe7whh3zu4ql5rvpg044lyk6cuu7fpnd9e",
                "validator_name": "Bit Cat🐱",
                "identity": "FAB46CEEAEAB9FA1",
                "annual_income": "0",
                "fee": "5",
                "jailed": true,
                "status": "unbonded",
                "voting_token": "9999307000000",
                "voting_rights": "0",
                "delegations_number": "",
                "logo_url": ""
            },
            {
                "validator_address": "cosmosvaloper1402ggxz5u6vm29sqztwqq8vxs3ke6dmwl2z5dk",
                "validator_name": "Cosmoon",
                "identity": "8935A6F323FA0881",
                "annual_income": "0",
                "fee": "0",
                "jailed": true,
                "status": "unbonded",
                "voting_token": "999911000000",
                "voting_rights": "0",
                "delegations_number": "",
                "logo_url": ""
            },
            {
                "validator_address": "cosmosvaloper1dt4h3hn9zpxvm2t26erf96aaszp3va2wkq28ez",
                "validator_name": "deleteme",
                "identity": "66425D7D043D9840",
                "annual_income": "0",
                "fee": "7",
                "jailed": true,
                "status": "unbonded",
                "voting_token": "999902000000",
                "voting_rights": "0",
                "delegations_number": "",
                "logo_url": ""
            },
            {
                "validator_address": "cosmosvaloper174glllafa668rcr2qzf5m0844ve60h0urf3h6u",
                "validator_name": "ChainPartners",
                "identity": "",
                "annual_income": "0",
                "fee": "3",
                "jailed": true,
                "status": "unbonded",
                "voting_token": "9999002000000",
                "voting_rights": "0",
                "delegations_number": "",
                "logo_url": ""
            }
        ],
        "nextkey": "WodWBjd5iBQDpRc"
    },
    "message": "OK"
}

# GET Acquire Delegation Info of the Address

/{coin}/v1/address/delegations

Acquire delegation info of the address

params type required note
address string yes Address to be inquired

The return format is as follows:

{
    "code": 0,
    "data": [
        {
            "coin": "ATOM",                                                              // coin/token
            "validator_address": "cosmosvaloper1qwl879nx9t6kef4supyazayf7vjhennyh568ys", // validator address
            "validator_name": "Certus One",                                              // validator name
            "delegation_balance": "0",                                                   // delegation balance
            "reward": "0",                                                               // to-be-withdrawn reward
            "re_delegates_time": 0,                                                      // locked time for delegation
            "unbonding_balance": "29.540058",                                            // unbonding delegation balance
            "unbonding_list": [                                                          // unbonding delegation balance info
                {
                    "balance": "29.540058",                                              // withdrawn balance
                    "completion_time": 1626246440                                        // withdrawn time
                }
            ]
        }
    ],
    "message": "OK"
}
Example Request
curl --location --request GET 'http://developers.viawallet.com/openapi/api/atom/v1/address/delegations?address=cosmos1gzc54u4p67hh9r4m9vcml3ke9fc29tplsefy6k' \
--header 'X-API-Key: BRfvZY97QaRa14Ci1F5vvP3KzwRxFFMw'
Example Response
200 OK

{
    "code": 0,
    "data": [
        {
            "coin": "ATOM",
            "validator_address": "cosmosvaloper1clpqr4nrk4khgkxj78fcwwh6dl3uw4epsluffn",
            "validator_name": "Cosmostation",
            "delegation_balance": "59.54537",
            "reward": "0.025716",
            "re_delegates_time": 1624442784,
            "unbonding_balance": "0",
            "unbonding_list": null
        },
        {
            "coin": "ATOM",
            "validator_address": "cosmosvaloper1ec3p6a75mqwkv33zt543n6cnxqwun37rr5xlqv",
            "validator_name": "lunamint",
            "delegation_balance": "19.9",
            "reward": "0.092896",
            "re_delegates_time": 0,
            "unbonding_balance": "0",
            "unbonding_list": null
        },
        {
            "coin": "ATOM",
            "validator_address": "cosmosvaloper1lzhlnpahvznwfv4jmay2tgaha5kmz5qxerarrl",
            "validator_name": "Citadel.one",
            "delegation_balance": "1.8001",
            "reward": "0.011429",
            "re_delegates_time": 0,
            "unbonding_balance": "0",
            "unbonding_list": null
        },
        {
            "coin": "ATOM",
            "validator_address": "cosmosvaloper1ey69r37gfxvxg62sh4r0ktpuc46pzjrm873ae8",
            "validator_name": "Sikka",
            "delegation_balance": "0",
            "reward": "0",
            "re_delegates_time": 0,
            "unbonding_balance": "0",
            "unbonding_list": null
        }
    ],
    "message": "OK"