(Core) Account History API

GET Account History #

GET /v2/newbridge/history

Returns a JSON structure with details of the NewBridge transfer history of the specified accounts.

API parameters #

Required #

Name In Type Description Enum Default
newchain_address query string At least one parameter should be provided in newchain_address and ethereum_address. NewChain address can be starting with NEW or using raw hex address starting with 0x.
ethereum_address query string At least one parameter should be provided in newchain_address and ethereum_address. Ethereum address should be starting with 0x.

Optional #

Name In Type Description Enum Default
page_id query integer Page number.
page_size query integer Number of results per page.
bridge_pair query string bridage pair blockchain name, merge of NewChain family and Ethtereum family, such as newchain-ethereum, newchain-hecochain, newchain-bschain. newchain-ethereum newchain-hecochain newchain-bschain 
curl -v https://replace-api-domain.ext/newbridge/history?newchain_address=0x97549E368AcaFdCAE786BB93D98379f1D1561a29&bridge_pair=newchain-ethereum&page_size=1

Response 200 # 

{
  "newchain_address": "NEW17zS9ZvgGV1EaT8KT2tLjqRvQbcApjFot8xj",
  "newchain_raw_address": "0x97549E368AcaFdCAE786BB93D98379f1D1561a29",
  "page_id": "1",
  "page_size": "1",
  "total_page": "6",
  "total_history": "53",
  "list": [
    {
      "from_network": "Ethereum",
      "from_sub_network": "Rinkeby",
      "from_chain_id": "4",
      "to_network": "NewChain",
      "to_sub_network": "Testnet",
      "to_chain_id": "1007",
      "from_address": "0xad61cc6653B62b7C05Bd2F593Bc49d22Fb901A9c",
      "from_raw_address": "0xad61cc6653B62b7C05Bd2F593Bc49d22Fb901A9c",
      "to_address": "NEW17zS9ZvgGV1EaT8KT2tLjqRvQbcApjFot8xj",
      "to_raw_address": "0x97549E368AcaFdCAE786BB93D98379f1D1561a29",
      "from_tx_hash": "0xad9716fdd2ae16840a96360e54dd683511a20a68c9e855c58ea333a3930206b2",
      "from_asset_type": "Token",
      "from_asset_name": "TestNet Launch",
      "from_asset_symbol": "TL",
      "from_asset_address": "0xCc5b1517bae326F8E147D6bEd17F5F53bc2f85c5",
      "to_tx_hash": "0x54b61d26348c2f6b71866620325c3ec39eaa8c5d1488cecc7f5b28422583bcc9",
      "to_asset_type": "Token",
      "to_asset_name": "TestNet Launch",
      "to_asset_symbol": "TL",
      "to_asset_address": "0x243a5C81C1F9970aa3e6f51d73fC13eE853FC338",
      "amount_requested": "14",
      "amount_fulfilled": "14",
      "fee": "0",
      "status": "Confirmed"
    }
  ]
}
Name Type Description
newchain_address String NewChain Address starting with NEW. Only one of newchain_address or ethereum_address will be returned.
ethereum_address String Ethereum Address starting with 0x. Only one of newchain_address or ethereum_address will be returned.
newchain_raw_address String NewChain Address in raw hex format starting with NEW.
page_id int Page number.
page_size int Number of results per page.
total_page int Number of total page.
total_history int Number of total results.
list BridgeHistory Array type of BridgeHistory.

Error Codes #

Status Code Description Params
400 account_not_found Acount was not found
400 address_is_in_invalid_format Requested address format is not valid { “type” => “newchain_address” } or { “type” => “ethereum_address” }
429 too_many_requests Too many requests have been made to the api.
500 internal_server_error Internal server error
503 service_unavailable Service is temporary unavailable
(Core) Account History API was last edited on 2021-05-20 @dd05b89 : update newbridge api v2
Source Edit