Package: mercado-bitcoin
Mercado Bitcoin API Client for PythonAPI Client in Python for Mercado BitcoinInstallationRun the following to install:pipinstallmercado-bitcoinUsageData APIfrommercado_bitcoinimportDataAPIimportjsonresp=DataAPI.day_summary('BTC',2019,9,11).json()print(json.dumps(resp,indent=2))Response:{"date":"2019-09-11","opening":41772.12033,"closing":41496.86984,"lowest":41200,"highest":41955.55,"volume":11179626.56206287,"quantity":269.18932163,"amount":7917,"avg_price":41530.72081153}Trade APIfrommercado_bitcoinimportTradeAPIimportjsonTAPI_ID=<your_tapi_id>TAPI_SECRET=<your_tapi_secret>tapi=TradeAPI(TAPI_ID,TAPI_SECRET)info=tapi.get_account_info()print(json.dumps(info,indent=2))Response{"response_data":{"balance":{"brl":{"available":"0.00000000","total":"0.00000000"},"btc":{"available":"0.00000000","total":"0.00000000","amount_open_orders":0},"ltc":{"available":"0.00000000","total":"0.00000000","amount_open_orders":0},"bch":{"available":"0.00000000","total":"0.00000000","amount_open_orders":0},"xrp":{"available":"0.00000000","total":"0.00000000","amount_open_orders":0},"eth":{"available":"0.00000000","total":"0.00000000","amount_open_orders":0}},"withdrawal_limits":{"brl":{"available":"20000.00","total":"20000.00"},"btc":{"available":"10.00000000","total":"10.00000000"},"ltc":{"available":"500.00000000","total":"500.00000000"},"bch":{"available":"25.00000000","total":"25.00000000"},"xrp":{"available":"20000.00000000","total":"20000.00000000"},"eth":{"available":"70.00000000","total":"70.00000000"}}},"status_code":100,"server_unix_timestamp":"1568299534"}Data API (API de Dados)O acesso à API de Dados é público, não é necessário criar uma conta tampouco autenticar.MethodDescriptiontickerRetorna informações com o resumo das últimas 24 horas de negociações.orderbookLivro de ofertas é composto por duas listas: (1) uma lista com as ofertas de compras ordenadas pelo maior valor; (2) uma lista com as ofertas de venda ordenadas pelo menor valor. O livro mostra até 1000 ofertas de compra e até 1000 ofertas de venda. Uma oferta é constituída por uma ou mais ordens, sendo assim, a quantidade da oferta é o resultado da soma das quantidades das ordens de mesmo preço unitário. Caso uma oferta represente mais de uma ordem, a prioridade de execução se dá com base na data de criação da ordem, da mais antiga para a mais nova.tradesHistórico de negociações realizadas.day-summaryRetorna resumo diário de negociações realizadas.Trade API (API de Negociacao)Para utilizar a API de negociações do Mercado Bitcoin são necessários:Criar uma contaGerar o PIN de SegurançaGerar uma chave da APIO acesso à API é limitado por padrão ao máximo de 60 requisições a cada 60 segundos, por usuário e não por chaveMethodDescriptionlist_system_messagesMétodo para comunicação de eventos do sistema relativos à TAPÌ, entre eles bugs, correções, manutenção programada e novas funcionalidades e versões. O conteúdo muda a medida que os eventos ocorrem. A comunicação externa, feita via Twitter e e-mail aos usuários da TAPI, continuará ocorrendo. Entretanto, essa forma permite ao desenvolvedor tratar as informações juntamente ao seus logs ou até mesmo automatizar comportamentos.get_account_infoRetorna dados da conta, como saldos das moedas (Real, BCash, Bitcoin, Ethereum, Litecoin e XRP), saldos considerando retenção em ordens abertas, quantidades de ordens abertas por moeda digital, limites de saque/transferências das moedas.get_orderRetorna os dados da ordem de acordo com o ID informado. Dentre os dados estão as informações das Operações executadas dessa ordem. Apenas ordens que pertencem ao proprietário da chave da TAPI pode ser consultadas. Erros específicos são retornados para os casos onde o order_id informado não seja de uma ordem válida ou pertença a outro usuário.list_ordersRetorna uma lista de até 200 ordens, de acordo com os filtros informados, ordenadas pela data de última atualização. As operações executadas de cada ordem também são retornadas. Apenas ordens que pertencem ao proprietário da chave da TAPI são retornadas. Caso nenhuma ordem seja encontrada, é retornada uma lista vazia.list_orderbookRetorna informações do livro de negociações (orderbook) do Mercado Bitcoin para o par de moedas (coin_pair) informado. Diferente do método orderbook público descrito em /api-doc/#method_trade_api_orderbook, aqui são fornecidas informações importantes para facilitar a tomada de ação de clientes TAPI e sincronia das chamadas. Dentre elas, o número da última ordem contemplada (latest_order_id) e número das ordens do livro (order_id), descritos abaixo. Importante salientar que nesse método ordens de mesmo preço não são agrupadas como feito no método público.place_buy_orderAbre uma ordem de compra (buy ou bid) do par de moedas, quantidade de moeda digital e preço unitário limite informados. A criação contempla o processo de confrontamento da ordem com o livro de negociações. Assim, a resposta pode informar se a ordem foi executada (parcialmente ou não) imediatamente após sua criação e, assim, se segue ou não aberta e ativa no livro.place_sell_orderAbre uma ordem de venda (sell ou ask) do par de moedas, quantidade de moeda digital e preço unitário limite informados. A criação contempla o processo de confrontamento da ordem com o livro de negociações. Assim, a resposta pode informar se a ordem foi executada (parcialmente ou não) imediatamente após sua criação e, assim, se segue ou não aberta e ativa no livro.place_market_buy_orderAbre uma ordem de compra (buy ou bid) do par de moedas com volume em reais limite informado. A criação contempla o processo de bloqueio do saldo para execução da ordem e confrontamento da ordem com o livro de negociações. Assim, a resposta pode informar se a ordem foi executada (parcialmente ou não) imediatamente após sua criação. Caso não seja possível executá-la totalmente por restrições no saldo disponível do usuário, o montante não executado é cancelado.place_market_sell_orderAbre uma ordem de venda (sell ou ask) do par de moeda com quantidade da moeda digital informado. A criação contempla o processo de confrontamento da ordem com o livro de negociações. Assim, a resposta pode informar se a ordem foi executada (parcialmente ou não) imediatamente após sua criação.cancel_orderCancela uma ordem, de venda ou compra, de acordo com o ID e par de moedas informado. O retorno contempla o sucesso ou não do cancelamento, bem como os dados e status atuais da ordem. Somente ordens pertencentes ao próprio usuário podem ser canceladas.get_withdrawalRetorna os dados de uma transferência de moeda digital ou de um saque de Real (BRL).withdraw_coinRequisita pedido de transferência de moeda digital ou saque de Real. Assim, caso o valor de coin seja BRL, então realiza um saque para a conta bancária informada. Caso o valor seja uma criptomoeda, realiza uma transação para o endereço de moeda digital informado.