def blockchain(self, min_height, max_height):
"""
Get block headers for minHeight <= height <= maxHeight.
Block headers are returned in descending order (highest first). Query Parameters
:param min_height: minimum height
:param max_height: maximum height
:return:
{'status': True, 'result': {'jsonrpc': '2.0', 'id': '', 'result': {'last_height': '9880808',
'block_metas': [{'block_id': {'hash': '5701A12896315A121303A979ACB707ACC447E20EFACFCB26174E9ED3997E2F5C',
'parts': {'total': '1', 'hash': '8C63BE3E3A221B984219CFAA1C196DDF0F202D68293311BFA9EE0B7A9155EACD'}},
'header': {'version': {'block': '10', 'app': '0'}, 'chain_id': 'Binance-Chain-Nile', 'height': '10',
'time': '2019-03-07T01:57:22.135103158Z', 'num_txs': '0', 'total_txs': '0', 'last_block_id':
{'hash': '1AF674F804E277354E8742176ECA74E338F52C237E6DBFF92819D75037E4F651', 'parts': {'total': '1',
'hash': 'BB3C36D5BBDAB441A7339385C071C4E804C4C3DD5C7BC15D60BC658A6B261906'}}, 'last_commit_hash':
'5442553C06521016756796015AF78FCAC752FFA9E94ACAF4DAA5DF4113B4B354', 'data_hash': '', 'validators_hash':
'80D9AB0FC10D18CA0E0832D5F4C063C5489EC1443DFB738252D038A82131B27A', 'next_validators_hash':
'80D9AB0FC10D18CA0E0832D5F4C063C5489EC1443DFB738252D038A82131B27A', 'consensus_hash':
'294D8FBD0B94B767A7EBA9840F299A3586DA7FE6B5DEAD3B7EECBA193C400F93', 'app_hash':
'E7D96927FD82FD910624AA8034B8A527FCEB1F7AB353DE789A3ECA8D400BDE31', 'last_results_hash': '', 'evidence_hash':
'', 'proposer_address': 'E0DD72609CC106210D1AA13936CB67B93A0AEE21'}}]}}}
"""
para = '?minHeight=%s&maxHeight=%s' % (min_height, max_height)
return std_ret(status=True,
data=self._wrapped_request(para=para).json())
def genesis(self):
"""
Get genesis file.
Sample Return:
{'status': True, 'result': {'jsonrpc': '2.0', 'id': '', 'result': {'genesis': {'genesis_time':
'2019-03-07T01:52:07.500913003Z', 'chain_id': 'Binance-Chain-Nile', 'consensus_params': {'block_size':
{'max_bytes': '1048576', 'max_gas': '-1'}, 'evidence': {'max_age': '100000'}, 'validator':
{'pub_key_types': ['ed25519']}}, 'app_hash': '', 'app_state': {'tokens': [{'name': 'Binance Chain Native Token',
'symbol': 'BNB', 'total_supply': '20000000000000000', 'owner': 'tbnb12hlquylu78cjylk5zshxpdj6hf3t0tahwjt3ex',
'mintable': False}], 'accounts': [{'name': 'Fuji', 'address': 'tbnb12hlquylu78cjylk5zshxpdj6hf3t0tahwjt3ex',
'valaddr': '7B343E041CA130000A8BC00C35152BD7E7740037'},
... ...
{'type': 'auth/StdTx', 'value': {'msg': [{'type': 'cosmos-sdk/MsgCreateValidatorProposal',
'value': {'MsgCreateValidator': {'Description': {'moniker': 'Zugspitze', 'identity': '', 'website': '',
'details': ''}, 'Commission': {'rate': '0', 'max_rate': '0', 'max_change_rate': '0'},
'delegator_address': 'tbnb108drn8exhv72tp40e6lq9z949nnjj54yzqrr2f', 'validator_address':
'bva108drn8exhv72tp40e6lq9z949nnjj54yvfth5u', 'pubkey': {'type': 'tendermint/PubKeyEd25519',
'value': 'yA6avvf/Q5wQxo/o8TA97d/FJ3GMOzfYumgHRG48gno='}, 'delegation': {'denom': 'BNB',
'amount': '100000000000'}}, 'proposal_id': '0'}}], 'signatures': [{'pub_key': {'type':
'tendermint/PubKeySecp256k1', 'value': 'A28N2eZXepmh+2enXvdAPqbbPf9yFCqYZleFjUMRJe0g'}, 'signature':
'egp4GjM/8PEVeFJiopen35eZzy/5NKjGKmK3MGpfmAFGQvjN6G4HyGX+6eigOuw40qpMdT9HYmvzSoa+jgXURQ==', 'account_number':
'0', 'sequence': '0'}], 'memo': '[email protected]:26656', 'source': '0',
'data': None}}, {'type': 'auth/StdTx', 'value': {'msg': [{'type': 'cosmos-sdk/MsgCreateValidatorProposal',
'value': {'MsgCreateValidator': {'Description': {'moniker': 'Gahinga', 'identity': '', 'website': '',
'details': ''}, 'Commission': {'rate': '0', 'max_rate': '0', 'max_change_rate': '0'}, 'delegator_address':
'tbnb1vehecekrsks5sshcwvxyeyrd469j9wvcqm37yu', 'validator_address': 'bva1vehecekrsks5sshcwvxyeyrd469j9wvcwj26f',
'pubkey': {'type': 'tendermint/PubKeyEd25519', 'value': 'kUKvzGkbfMBdJsewvgyLRkGClBcXMOB584T94vpQuvw='},
'delegation': {'denom': 'BNB', 'amount': '100000000000'}}, 'proposal_id': '0'}}], 'signatures': [{'pub_key':
{'type': 'tendermint/PubKeySecp256k1', 'value': 'AsS8HffgT0IIai/sesaWtW5wurpu7eBDkhu0esmwjsnc'},
'signature': 'k6LegehVpGnjQ4ePBwJajrbKlPg5tXQMkBtIZ+nbMNAHp4Z2IihYrUGMAoKu0B0LJbbNH/7Gq7b0AK5HfYEByg==',
'account_number': '0', 'sequence': '0'}], 'memo': '[email protected]:256',
'source': '0', 'data': None}}]}}}}}
"""
return std_ret(status=True,
data=self._wrapped_request().json())
def get_order_closed(self,
address,
end=None,
side=None,
start=None,
status=None,
symbol=None,
limit=500,
offset=0,
total=0):
"""
- Summary: Get closed orders.
- Description: Gets closed (filled and cancelled) orders for a given address.
- Query Window: Default query window is latest 7 days; The maximum start - end query window is 3 months.
- Rate Limit: 5 requests per IP per second.
:return:
"""
if status and status not in api_types_instance.allowed_order_status:
return std_ret(
False, 'Status should be in: %s' %
api_types_instance.allowed_order_status)
url = '%sapi/v1/orders/closed?address=%s&limit=%s&offset=%s&total=%s' % \
(self.api_base_url_with_port, address, limit, offset, total)
url = url + '&symbol=%s' % symbol if symbol else url
url = url + '&start=%s' % start if start else url
url = url + '&end=%s' % end if end else url
url = url + '&side=%s' % side if side else url
url = url + '&status=%s' % status if status else url
ret = binance_api_request(url=url, method='GET')
return ret
def block(self, height=None):
"""
Get block at a given height
:param height: If no height is provided, it will fetch the latest block
Sample Return:
{'status': True, 'result': {'jsonrpc': '2.0', 'id': '', 'result': {'block_meta': {'block_id':
{'hash': '5701A12896315A121303A979ACB707ACC447E20EFACFCB26174E9ED3997E2F5C', \
'parts': {'total': '1', 'hash': '8C63BE3E3A221B984219CFAA1C196DDF0F202D68293311BFA9EE0B7A9155EACD'}},
'header': {'version': {'block': '10', 'app': '0'}, 'chain_id': 'Binance-Chain-Nile',
'height': '10', 'time': '2019-03-07T01:57:22.135103158Z', 'num_txs': '0', 'total_txs': '0',
'last_block_id': {'hash': '1AF674F804E277354E8742176ECA74E338F52C237E6DBFF92819D75037E4F651', 'parts':
{'total': '1', 'hash': 'BB3C36D5BBDAB441A7339385C071C4E804C4C3DD5C7BC15D60BC658A6B261906'}},
'last_commit_hash': '5442553C06521016756796015AF78FCAC752FFA9E94ACAF4DAA5DF4113B4B354', 'data_hash': '',
'validators_hash': '80D9AB0FC10D18CA0E0832D5F4C063C5489EC1443DFB738252D038A82131B27A',
'next_validators_hash': '80D9AB0FC10D18CA0E0832D5F4C063C5489EC1443DFB738252D038A82131B27A',
'consensus_hash': '294D8FBD0B94B767A7EBA9840F299A3586DA7FE6B5DEAD3B7EECBA193C400F93',
'app_hash': 'E7D96927FD82FD910624AA8034B8A527FCEB1F7AB353DE789A3ECA8D400BDE31',
'last_results_hash': '', 'evidence_hash': '', 'proposer_address': 'E0DD72609CC106210D1AA13936CB67B93A0AEE21'}},
... ...
{'type': 2, 'height': '9', 'round': '0', 'block_id':
{'hash': '1AF674F804E277354E8742176ECA74E338F52C237E6DBFF92819D75037E4F651', 'parts': {'total': '1',
'hash': 'BB3C36D5BBDAB441A7339385C071C4E804C4C3DD5C7BC15D60BC658A6B261906'}},
'timestamp': '2019-03-07T01:57:22.129274247Z',
'validator_address': 'FC3108DC3814888F4187452182BC1BAF83B71BC9', 'validator_index': '10',
'signature': '55nxVx9iBFPTEuhuN806WyyBUwX1Hf4h24JSalcR6duQRxjFrLgm//eo7Bhh93jMikBTMA2ThQ+Mzc3A/wd8Dg=='}]}}}}}
"""
para = '?height=%s' % height if height else ''
return std_ret(status=True,
data=self._wrapped_request(para=para).json())
def get_depth(self, symbol, limit=None):
"""
- Summary: Get the order book.
- Description: Gets the order book depth data for a given pair symbol.
- The given limit must be one of the allowed limits below.
- Destination: Validator node.
- Rate Limit: 10 requests per IP per second.
:param symbol: Market pair symbol, e.g. NNB-0AD_BNB
:param limit:
limited to: [5, 10, 20, 50, 100, 500, 1000]
:return:
{'status': True, 'result': {'asks': [], 'bids': [], 'height': 8034721}}
"""
# inputs Validation
if limit and limit not in api_types_instance.allowed_depth_limit:
return std_ret(
False, 'Limit must be in: %s' %
api_types_instance.allowed_depth_limit)
url = '%sapi/v1/depth?symbol=%s' % (self.api_base_url_with_port,
symbol)
url = url + '&limit=%s' % limit if limit else url
ret = binance_api_request(url=url, method='GET')
return ret
def num_unconfirmed_txs(self):
"""
Get number of unconfirmed transactions
Sample Return:
{'status': True, 'result': {'jsonrpc': '2.0', 'id': '', 'result': {'listening': True, 'listeners':
['Listener(@a41086771245011e988520ad55ba7f5a-5f7331395e69b0f3.elb.us-east-1.amazonaws.com:27146)'],
'n_peers': '3', 'peers': [{'node_info': {'protocol_version': {'p2p': '7', 'block': '10', 'app': '0'},
'id': '381934b9b3f862d1e81e699d8e1d38929f330cef', 'listen_addr': 'aa13359cd244f11e988520ad55ba7f5a-
c3963b80c9b991b7.elb.us-east-1.amazonaws.com:27146', 'network': 'Binance-Chain-Nile', 'version': '0.30.1',
'channels': '354020212223303800', 'moniker': 'data-seed-0', 'other': {'tx_index': 'on', 'rpc_address':
'tcp://0.0.0.0:27147'}}, 'is_outbound': True, 'connection_status': {'Duration': '256165709941240',
'SendMonitor': {'Active': True, 'Start': '2019-04-10T06:58:59.94Z', 'Duration': '256165720000000',
'Idle': '160000000', 'Bytes': '986939740', 'Samples': '1725510', 'InstRate': '778', 'CurRate': '2887',
'AvgRate': '3853', 'PeakRate': '92740', 'BytesRem': '0', 'TimeRem': '0', 'Progress': 0}, 'RecvMonitor':
{'Active': True, 'Start': '2019-04-10T06:58:59.94Z', 'Duration': '256165720000000', 'Idle': '160000000',
'Bytes': '5041382073', 'Samples': '1816727', 'InstRate': '7456', 'CurRate': '18329', 'AvgRate': '19680',
'PeakRate': '1135920', 'BytesRem': '0', 'TimeRem': '0', 'Progress': 0}, 'Channels': [{'ID': 48,
'SendQueueCapacity': '1', 'SendQueueSize': '0', 'Priority': '5', 'RecentlySent': '0'},
... ...
{'ID': 35, 'SendQueueCapacity': '2', 'SendQueueSize': '0', 'Priority': '1', 'RecentlySent': '121'},
{'ID': 56, 'SendQueueCapacity': '1', 'SendQueueSize': '0', 'Priority': '5', 'RecentlySent': '0'},
{'ID': 0, 'SendQueueCapacity': '10', 'SendQueueSize': '0', 'Priority': '1', 'RecentlySent': '140'}]},
'remote_ip': '52.200.132.60'}]}}}
"""
return std_ret(status=True,
data=self._wrapped_request().json())
def get_commit(self, height=None):
"""
Get block commit at a given height.
:param height: If no height is provided, it will fetch the commit for the latest block.
Sample Return:
{'status': True, 'result': {'jsonrpc': '2.0', 'id': '', 'result': {'signed_header': {'header': {'version':
{'block': '10', 'app': '0'}, 'chain_id': 'Binance-Chain-Nile', 'height': '10', 'time':
'2019-03-07T01:57:22.135103158Z', 'num_txs': '0', 'total_txs': '0', 'last_block_id':
{'hash': '1AF674F804E277354E8742176ECA74E338F52C237E6DBFF92819D75037E4F651', 'parts': {'total': '1',
'hash': 'BB3C36D5BBDAB441A7339385C071C4E804C4C3DD5C7BC15D60BC658A6B261906'}},
'last_commit_hash': '5442553C06521016756796015AF78FCAC752FFA9E94ACAF4DAA5DF4113B4B354', 'data_hash': '',
'validators_hash': '80D9AB0FC10D18CA0E0832D5F4C063C5489EC1443DFB738252D038A82131B27A',
'next_validators_hash': '80D9AB0FC10D18CA0E0832D5F4C063C5489EC1443DFB738252D038A82131B27A',
'consensus_hash': '294D8FBD0B94B767A7EBA9840F299A3586DA7FE6B5DEAD3B7EECBA193C400F93',
'app_hash': 'E7D96927FD82FD910624AA8034B8A527FCEB1F7AB353DE789A3ECA8D400BDE31', 'last_results_hash': '',
'evidence_hash': '', 'proposer_address': 'E0DD72609CC106210D1AA13936CB67B93A0AEE21'}, 'commit':
{'block_id': {'hash': '5701A12896315A121303A979ACB707ACC447E20EFACFCB26174E9ED3997E2F5C',
'parts': {'total': '1', 'hash': '8C63BE3E3A221B984219CFAA1C196DDF0F202D68293311BFA9EE0B7A9155EACD'}},
'precommits': [None, {'type': 2, 'height': '10', 'round': '1', 'block_id':
{'hash': '5701A12896315A121303A979ACB707ACC447E20EFACFCB26174E9ED3997E2F5C', 'parts': {'total': '1',
'hash': '8C63BE3E3A221B984219CFAA1C196DDF0F202D68293311BFA9EE0B7A9155EACD'}},
'timestamp': '2019-03-07T01:57:27.663157746Z', 'validator_address': '18E69CC672973992BB5F76D049A5B2C5DDF77436',
'validator_index': '1', 'signature': 'ZrnapmTAiJrhm0DVIoTzRbJG+FDCAxBpfamYxZj2eg0+wY0+KDg48sDPlD+chk97ti01PukuVs
ftn4U6HXbkCA=='},
... ...
'timestamp': '2019-03-07T01:57:27.738256001Z', 'validator_address': 'FC3108DC3814888F4187452182BC1BAF83B71BC9',
'validator_index': '10', 'signature': 'Hw1BdfL79cLsTJhb406k+1MvU27zL1pdehLBHqkzF5NNOn/LrL4+u3t2ANwHaxX5OFijg
ZW5P1T7ECVrvJr0CQ=='}]}}, 'canonical': True}}}\
"""
para = '?height=%s' % height if height else ''
return std_ret(status=True,
data=self._wrapped_request(para=para).json())
def consensus_state(self):
"""
ConsensusState returns a concise summary of the consensus state.
Please note: when i am writting this SDK now, official site say this is UNSTABLE
Sample Return:
{'status': True, 'result': {'jsonrpc': '2.0', 'id': '', 'result': {'round_state':
{'height/round/step': '7967291/0/4', 'start_time': '2019-04-13T05:30:11.319742433Z',
'proposal_block_hash': 'E0488FF746BFD917C1F2A11C9AC15ACC50381275CF985D2356A8DBF85291F8A8',
'locked_block_hash': '', 'valid_block_hash': '', 'height_vote_set': [{'round': '0',
'prevotes': ['Vote{0:06FD60078EB4 7967291/00/1(Prevote)
E0488FF746BF 0F15F05DAAE3 @ 2019-04-13T05:30:10.275300968Z}', 'Vote{1:18E69CC67297 7967291/00/1(Prevote)
E0488FF746BF 33D396EF0423 @ 2019-04-13T05:30:10.327996565Z}', 'Vote{2:344C39BB8F45 7967291/00/1(Prevote)
E0488FF746BF 7C71204358A5 @ 2019-04-13T05:30:10.323741771Z}', 'Vote{3:37EF19AF2967 7967291/00/1(Prevote)
E0488FF746BF 7560AE249E1F @ 2019-04-13T05:30:10.290388253Z}', 'nil-Vote', 'nil-Vote', 'Vote{6:91844D296BD8
... ...
E0488FF746BF 15C6E26CCBB9 @ 2019-04-13T05:30:10.290430937Z}', 'nil-Vote', 'nil-Vote'], 'prevotes_bit_array':
'BA{11:xxxx__xxx__} 700000000000/1100000000000 = 0.64', 'precommits': ['nil-Vote', 'nil-Vote', 'nil-Vote',
'nil-Vote', 'nil-Vote', 'nil-Vote', 'nil-Vote', 'nil-Vote', 'nil-Vote', 'nil-Vote', 'nil-Vote'],
'precommits_bit_array': 'BA{11:___________} 0/1100000000000 = 0.00'}, {'round': '1',
'prevotes': ['nil-Vote', 'nil-Vote', 'nil-Vote', 'nil-Vote', 'nil-Vote', 'nil-Vote', 'nil-Vote', 'nil-Vote',
'nil-Vote', 'nil-Vote', 'nil-Vote'], 'prevotes_bit_array': 'BA{11:___________} 0/1100000000000 = 0.00',
'precommits': ['nil-Vote', 'nil-Vote', 'nil-Vote', 'nil-Vote', 'nil-Vote', 'nil-Vote', 'nil-Vote', 'nil-Vote',
'nil-Vote', 'nil-Vote', 'nil-Vote'], 'precommits_bit_array': 'BA{11:___________} 0/1100000000000 = 0.00'}]}}}}
"""
return std_ret(status=True,
data=self._wrapped_request().json())
def unconfirmed_txs(self):
"""
Get unconfirmed transactions (maximum ?limit entries) including their number.
Sample Return:
{'status': True, 'result': {'jsonrpc': '2.0', 'id': '', 'result': {'n_txs': '0', 'txs': []}}}
"""
return std_ret(status=True,
data=self._wrapped_request().json())
def abci_info(self):
"""
Get some info about the application
Sample Return:
{'status': True, 'result': {'jsonrpc': '2.0', 'id': '', 'result': {'response': {'data': 'BNBChain',
'last_block_height': '7958684', 'last_block_app_hash': 'KI9O19xiqBUitt93GThsvYMs8UJ5fO6OcmKw+q5HQM8='}}}}
"""
return std_ret(status=True,
data=self._wrapped_request().json())
def broadcast_tx_async(self, tx_id):
"""
Broadcase Transaction (Async), returns right away, with no response
:param tx_id: Transaction id
Sample Return:
{'status': True, 'result': {'jsonrpc': '2.0', 'id': '', 'result': {'code': 0, 'data': '', 'log': '',
'hash': 'A665A45920422F9D417E4867EFDC4FB8A04A1F3FFF1FA07E998E86F7F7A27AE3'}}}
"""
para = '?tx="%s"' % tx_id
return std_ret(status=True,
data=self._wrapped_request(para=para).json())
def broadcast_tx_sync(self, tx_id):
"""
Broadcase Transaction, returns with the response from CheckTx.
:param tx_id: Transaction id
Sample Return:
{'status': True, 'result': {'jsonrpc': '2.0', 'id': '', 'result': {'code': 65538, 'data': '',
'log': '{"codespace":1,"code":2,"abci_code":65538,"message":"tx parse error"}',
'hash': 'A665A45920422F9D417E4867EFDC4FB8A04A1F3FFF1FA07E998E86F7F7A27AE3'}}}\
"""
para = '?tx="%s"' % tx_id
return std_ret(status=True,
data=self._wrapped_request(para=para).json())
def consensus_params(self, height=None):
"""
Get the consensus parameters at the given block height.
:param height: If no height is provided, it will fetch the current consensus params
Sample Return:
{'status': True, 'result': {'jsonrpc': '2.0', 'id': '', 'result': {'block_height': '100', 'consensus_params':
{'block_size': {'max_bytes': '1048576', 'max_gas': '-1'}, 'evidence': {'max_age': '100000'},
'validator': {'pub_key_types': ['ed25519']}}}}}
"""
para = '?height=%s' % height if height else ''
return std_ret(status=True,
data=self._wrapped_request(para=para).json())
def broadcast_tx_commit(self, tx_id):
"""
CONTRACT: only returns error if mempool.CheckTx() errs or if we timeout waiting for tx to commit.
If CheckTx or DeliverTx fail, no error will be returned, but the returned result will contain a non-OK ABCI code.
:param tx_id: Transaction id
Sample Return:
{'status': True, 'result': {'jsonrpc': '2.0', 'id': '', 'result': {'check_tx': {'code': 65538,
'log': '{"codespace":1,"code":2,"abci_code":65538,"message":"tx parse error"}'}, 'deliver_tx': {},
'hash': 'A665A45920422F9D417E4867EFDC4FB8A04A1F3FFF1FA07E998E86F7F7A27AE3', 'height': '0'}}}
"""
para = '?tx="%s"' % tx_id
return std_ret(status=True,
data=self._wrapped_request(para=para).json())
def block_results(self, height=None):
"""
BlockResults gets ABCIResults at a given height.
Results are for the height of the block containing the txs. Thus response.results[5] is the results of executing getBlock(h).Txs[5
:param height: If no height is provided, it will fetch results for the latest block.
Sample Return:
{'status': True, 'result': {'jsonrpc': '2.0', 'id': '', 'result': {'height': '100', 'results':
{'DeliverTx': None, 'EndBlock': {'validator_updates': None}, 'BeginBlock': {}}}}}
"""
para = '?height=%s' % height if height else ''
return std_ret(status=True,
data=self._wrapped_request(para=para).json())
def status(self):
"""
Get Tendermint status including node info, pubkey, latest block hash, app hash, block height and time.
Sample Return:
{'status': True, 'result': {'jsonrpc': '2.0', 'id': '', 'result': {'node_info': {'protocol_version':
{'p2p': '7', 'block': '10', 'app': '0'}, 'id': '2726550182cbc5f4618c27e49c730752a96901e8',
'listen_addr': 'a41086771245011e988520ad55ba7f5a-5f7331395e69b0f3.elb.us-east-1.amazonaws.com:27146',
'network': 'Binance-Chain-Nile', 'version': '0.30.1', 'channels': '354020212223303800', 'moniker': 'seed',
'other': {'tx_index': 'on', 'rpc_address': 'tcp://0.0.0.0:27147'}}, 'sync_info':
{'latest_block_hash': '18BCD3A2AD5DC4543F76FF91BB43666B10C5247D67F7899F60DC33D33EC14551',
'latest_app_hash': 'A196E89AC524C0753396BBFF07C08DDE2C9D11B09AD1E63E58D820D9C050321E',
'latest_block_height': '7973492', 'latest_block_time': '2019-04-13T06:12:17.508711551Z',
'catching_up': False}, 'validator_info': {'address': 'D618BA9C703B1E2A6BC7BAB0A0E66CE5FA32BCBA',
'pub_key': {'type': 'tendermint/PubKeyEd25519', 'value': 'fHM2q0J/CBzMnfH1TYtKsMQ+VmJQaq5ZsMMtmT2VoFs='},
'voting_power': '0'}}}}
"""
return std_ret(status=True,
data=self._wrapped_request().json())
def transaction(self, hash):
"""
query the transaction results. nil could mean the transaction is in the mempool, invalidated,
or was not sent in the first place.
:param hash: Transaction hash
Sample Return:
{'status': True, 'result': {'jsonrpc': '2.0', 'id': '', 'result':
{'hash': 'C3FF309D7226768FC48B5E2D2D91719D77BAFA66DF7D3C53FCB212075DA83EA3', 'height': '7554709', 'index': 1,
'tx_result': {'data': 'eyJvcmRlcl9pZCI6IjFENTE4QTI1NjNCMENCOTEyQUQ3MERFQjdBMThDRDdFRDJGQkI3RDQtMTcifQ==',
'log': 'Msg 0: ', 'tags': [{'key': 'YWN0aW9u', 'value': 'b3JkZXJOZXc='}]},
'tx': '4AHwYl3uCmbObcBDChQdUYolY7DLkSrXDet6GM1+0vu31BIrMUQ1MThBMjU2M0IwQ0I5MTJBRDcwREVCN0ExOENEN0VEMkZCQjdENC0x
NxoMMTAwSy05QkNfQk5CIAIoATCA4I2E3csBOJBOQAEScAom61rphyEDfd0CH3JYj3jMG0VLIE8zyIjfRNNMf7OUXk8WLuEZYRISQGu/gqP4ikv
Xn5mY3/EZJ2wMqbTi+guJBj7DXtGtVGBAY8LiliUE2UhD1YtBdMjgQcuGExOES1Qbuck4aB+q0U8YvtcoIBAgAQ=='}}}
"""
para = '?hash=0x%s' % hash
return std_ret(status=True,
data=self._wrapped_request(para=para).json())
def get_list(self):
"""
shows a list of available endpoints
Sample Return:
{'status': True, 'result': '<html><body><br>Available endpoints:<br><a href="//seed-pre-s3.binance.org/
abci_info">//seed-pre-s3.binance.org/abci_info</a></br><a href="//seed-pre-s3.binance.org/consensus_state">
//seed-pre-s3.binance.org/consensus_state</a></br><a href="//seed-pre-s3.binance.org/dump_consensus_state">
//seed-pre-s3.binance.org/dump_consensus_state</a></br><a href="//seed-pre-s3.binance.org/genesis">
//seed-pre-s3.binance.org/genesis</a></br><a href="//seed-pre-s3.binance.org/health">//seed-pre-s3.binance.org
/health</a></br><a href="//seed-pre-s3.binance.org/net_info">//seed-pre-s3.binance.org/net_info</a></br>
<a href="//seed-pre-s3.binance.org/num_unconfirmed_txs">//seed-pre-s3.binance.org/num_unconfirmed_txs</a></br>
<a href="//seed-pre-s3.binance.org/status">//seed-pre-s3.binance.org/status</a></br>
<br>Endpoints that require arguments:<br><a href="//seed-pre-s3.binance.org/abci_query?path=_&data=_&height=
_&prove=_">//seed-pre-s3.binance.org/abci_query?path=_&data=_&height=_&prove=_</a></br>
<a href="//seed-pre-s3.binance.org/block?height=_">//seed-pre-s3.binance.org/block?height=_</a></br>
<a href="//seed-pre-s3.binance.org/block_results?height=_">
... ...
//seed-pre-s3.binance.org/validators?height=_</a></br></body></html>'}
"""
return std_ret(status=True,
data=self._wrapped_request().text)
def validators(self, height=None):
"""
Get the validator set at the given block height. If no height is provided, it will fetch the current validator set.
Sample Return:
{'status': True, 'result': {'jsonrpc': '2.0', 'id': '', 'result': {'block_height': '10', 'validators':
[{'address': '06FD60078EB4C2356137DD50036597DB267CF616', 'pub_key': {'type': 'tendermint/PubKeyEd25519',
'value': '4Xy+nCDNz9+HazsSl40yZKAH/KqnHEzbcB2evAMj9E8='}, 'voting_power': '100000000000', 'proposer_priority':
'-100000000000'}, {'address': '18E69CC672973992BB5F76D049A5B2C5DDF77436', 'pub_key': {'type':
'tendermint/PubKeyEd25519', 'value': 'GE57ED00xBAD+bhk1fjBrdqb0ENrJTuzyES8c5wed8k='},
'voting_power': '100000000000', 'proposer_priority': '-100000000000'},
{'address': '344C39BB8F4512D6CAB1F6AAFAC1811EF9D8AFDF', 'pub_key': {'type': 'tendermint/PubKeyEd25519',
'value': 'TUIK6oQ+kqDP5p2JaW3/aCd2n5y1KiSa9TfOib8qS3Q='}, 'voting_power': '100000000000',
'proposer_priority': '-100000000000'}, {'address': '37EF19AF29679B368D2B9E9DE3F8769B35786676',
'pub_key': {'type': 'tendermint/PubKeyEd25519', 'value': 'vQPen4qynigACU4VP6xvaWz6USU2ycL4BNyywsTkrtY='},
'voting_power': '100000000000', 'proposer_priority': '-100000000000'},
{'address': '62633D9DB7ED78E951F79913FDC8231AA77EC12B', 'pub_key': {'type': 'tendermint/PubKeyEd25519',
'value': 'j0p0oHNRiV3fNzBXuY+ubfryzSHzegY+GWAQeP5HDVM='}, 'voting_power': '100000000000',
'proposer_priority': '-100000000000'}, {'address': '7B343E041CA130000A8BC00C35152BD7E7740037',
'pub_key': {'type': 'tendermint/PubKeyEd25519', 'value': 'Sl1HU+t5+S6A7+It96yk9mak9Ev4HFNsSgnUucW2VLU='},
'voting_power': '100000000000', 'proposer_priority': '-100000000000'},
{'address': '91844D296BD8E591448EFC65FD6AD51A888D58FA', 'pub_key': {'type': 'tendermint/PubKeyEd25519',
'value': 'yA6avvf/Q5wQxo/o8TA97d/FJ3GMOzfYumgHRG48gno='}, 'voting_power': '100000000000',
'proposer_priority': '-100000000000'}, {'address': 'B3727172CE6473BC780298A2D66C12F1A14F5B2A',
'pub_key': {'type': 'tendermint/PubKeyEd25519', 'value': 'kUKvzGkbfMBdJsewvgyLRkGClBcXMOB584T94vpQuvw='},
'voting_power': '100000000000', 'proposer_priority': '-100000000000'},
{'address': 'B6F20C7FAA2B2F6F24518FA02B71CB5F4A09FBA3', 'pub_key': {'type': 'tendermint/PubKeyEd25519',
'value': 'SbKI5Ou7OigcLVRvwwJT1brwiZO25dKV+3h6WzFKKY4='}, 'voting_power': '100000000000',
'proposer_priority': '-100000000000'}, {'address': 'E0DD72609CC106210D1AA13936CB67B93A0AEE21',
'pub_key': {'type': 'tendermint/PubKeyEd25519', 'value': 'BCJDOWiPAS5kneSOJBiACS6qj2qg9PFL/Pngx2kXwLY='},
'voting_power': '100000000000', 'proposer_priority': '-100000000000'}, {'address':
'FC3108DC3814888F4187452182BC1BAF83B71BC9', 'pub_key': {'type': 'tendermint/PubKeyEd25519',
'value': 'QDSzfO2ooL8Tsauu7nqPk4NUIJmlVNIZuT0M5p45cOg='}, 'voting_power': '100000000000',
'proposer_priority': '1000000000000'}]}}}
"""
para = '?height=%s' % height if height else ''
return std_ret(status=True,
data=self._wrapped_request(para).json())
def _wrapped_request(self, para=None):
# Get caller function name
caller_func_name = inspect.stack()[1].function
# todo:
# refer to: https://stackoverflow.com/questions/900392/getting-the-caller-function-name-inside-another-function-in-python/900413
# seems caller_func_name is different from python 3 and python 2, need to test on python 2
# Get ws name from Mapper
node_rpc_entry_point = NODE_RPC_ENTRY_POINT_MAPPING[caller_func_name]
# Perform Request
request_url = self.node_url + node_rpc_entry_point
if para:
request_url += para
print('Request URL: %s ... ...' % request_url)
try:
req_ret = requests.get(request_url)
return req_ret
except Exception as err:
return std_ret(status=False,
data='%s' % err)
def get_klines(self,
trading_pair,
interval='4h',
start_time=None,
end_time=None,
limit=300):
"""
- Summary: Get candlestick bars.
- Description: Gets candlestick/kline bars for a symbol. Bars are uniquely identified by their open time.
- If the time window is larger than limits, only the first n klines will return. In this case, please either shrink the window or increase the limit to get proper amount of klines.
- Rate Limit: 10 requests per IP per second.
:param trading_pair: <Trading Pair> example: 'BEY-8C6_BNB'
:param interval:
limited to: ['1m', '3m', '5m', '15m', '30m', '1h', '2h', '4h', '6h', '8h', '12h', '1d', '3d', '1w', '1M']
:param start_time: start time in Milliseconds
:param end_time: end time in Milliseconds
:param limit: default 300; max 1000.
:return:
{'status': True, 'result': [
{'open_time_stamp': 1552161600000, 'open_time_datetime': datetime.datetime(2019, 3, 9, 20, 0),
'price_open': '1.00000000', 'price_high': '14.90000000', 'price_low': '0.00001000',
'price_close': '6.10000000', 'volume': '3.13200000', 'close_time_stamp': 1552175999999,
'close_time_datetime': datetime.datetime(2019, 3, 9, 23, 59, 59), 'quote_asset_volume': '2.22192000',
'num_trades': 135},
... ...]}
"""
# inputs Validation
if interval not in api_types_instance.allowed_kline_interval:
return std_ret(
False, 'Interval but be in: %s' %
api_types_instance.allowed_kline_interval)
url = '%sapi/v1/klines?interval=%s&limit=%s&symbol=%s' % (
self.api_base_url_with_port, interval, limit, trading_pair)
url = url + '&startTime=%s' % start_time if start_time else url
url = url + '&endTime=%s' % end_time if end_time else url
res = requests.get(url)
status_code = res.status_code
if status_code == 200:
ret = res.json()
ret = [{
'open_time_stamp':
elem[0],
'open_time_datetime':
datetime.datetime.utcfromtimestamp(int(str(elem[0])[:-3])),
'price_open':
elem[1],
'price_high':
elem[2],
'price_low':
elem[3],
'price_close':
elem[4],
'volume':
elem[5],
'close_time_stamp':
elem[6],
'close_time_datetime':
datetime.datetime.utcfromtimestamp(int(str(elem[6])[:-3])),
'quote_asset_volume':
elem[7],
'num_trades':
elem[8]
} for elem in ret]
return std_ret(True, ret)
else:
return std_ret(False, 'Server Error, status_code=%s' % status_code)
