Acesso à API de Dados
O acesso à API de Dados é público, não é necessário criar uma conta tampouco autenticar.
Estrutura das Requisições
URL
É necessário fazer uma chamada HTTP, método GET, para a URL https://www.mercadobitcoin.net/api/
<coin>
/<method>
/Parâmetros de URL
Dois parâmetros são obrigatórios e presentes em todas as requisições:
coin
: Acrônimo da moeda digitalTipo: String
Domínio de dados:AAVE : Aave
ACH : Alchemy Pay
ACMFT : AC Milan
ACORDO01 : None
ADA : Cardano
ADS : Adshares
AGIX : SingularityNET
AIOZ : Aioz
ALCX : Alchemix
ALGO : Algorand
ALICE : MyNeighborAlice
ALLFT : Alliance
ALPHA : Alpha Venture Dao
AMFT : Aston Martin Cognizant
AMP : Amp
ANKR : ANKR
ANT : Aragon
APE : ApeCoin
API3 : API3
ARGFT : Argentine Football Association
ASRFT : AS Roma
ATLAS : Star Atlas
ATMFT : Fan Token ATM
ATOM : Cosmos
AUDIO : Audius
AVAX : Avalanche
AXS : Axie Infinity
BADGER : Badger DAO
BAL : Balancer
BAND : Band Protocol
BARFT : FC Barcelona
BAT : Basic Attention token
BCH : Bitcoin Cash
BICO : Biconomy
BLZ : Bluzelle
BNT : BANCOR
BTC : Bitcoin
BTRST : Braintrust
CAIFT : Fan Token CAI
CEEK : CEEK VR
CHZ : Chiliz
CITYFT : Manchester City FC
CLV : Clover Finance
COMP : Compound
COTI : COTI
CRV : Curve Dao Token
CSCONS01 : Consorcio CS01
CSCONS02 : Consorcio CS02
CSCONS03 : Consórcio CS03
CSCONS04 : Consorcio CS04
CSCONS05 : Consorcio CS05
CTSI : Cartesi
CVC : Civic
CVX : Convex Finance
DAI : Dai
DG : Decentral Games
DIA : DIA
DOGE : Dogecoin
DOT : Polkadot
DPI : DeFi Pulse Index
DYDX : dYdX
ENER01 : Token de Energia
ENJ : Enjin Coin
ENS : Ethereum Name Service
ERN : Ethernity
ETH : Ethereum
FARM : Harvest Finance
FET : Fetch.ai
FIL : Filecoin
FLOKI : Floki Inu
FLOW : Flow
GALA : Gala
GALFT : Galatasaray
GALOFT : Clube Atletico Mineiro
GHST : Aavegotchi
GMT : STEPN
GNO : Gnosis
GODS : Gods Unchained
GRT : The Graph
GST : Green Satoshi Token
HIGH : Highstreet
HOT : Holo
ICP : Internet Computer
ILV : Illuvium
IMOB01 : None
IMOB02 : None
IMX : Immutable X'
INTERFT : Inter Milan
JASMY : JasmyCoin
JUVFT : Juventus
KEEP : Keep Network
KNC : Kyber Network
KP3R : Keep3rV1
KSM : Kusama
LDO : Lido DAO Token
LINK : Chainlink
LOOKS : LooksRare
LPT : Livepeer
LQTY : Liquity
LRC : Loopring
LTC : Litecoin
MANA : MANA (Decentraland)
MATIC : Polygon
MBCCSH01 : Consorcio H01
MBCCSH02 : Consorcio H02
MBCCSH03 : Consorcio H03
MBCONS01 : Cota de Consórcio 01
MBCONS02 : Cota de Consórcio 02
MBFP01 : None
MBFP02 : None
MBFP03 : Fluxo de Pagamento 03
MBFP04 : Fluxo de pagamento 04
MBFP05 : None
MBFP06 : Fluxos de Pagamento 06
MBFP07 : Fluxos de Pagamento 07
MBFP08 : Fluxos de Pagamento 08
MBFP09 : Fluxos de Pagamento 09
MBFP10 : Fluxos de Pagamento 10
MBFP11 : Fluxos de Pagamento 11
MBPRK01 : Precatório MB SP01
MBPRK02 : Precatório MB SP02
MBPRK03 : Precatório MB BR03
MBPRK04 : Precatório MB RJ04
MBPRK05 : Fluxo de Pagamentos 5
MBPRK06 : Precatorio MB BR06
MBPRK07 : Precatorio MB SP07
MBSANTOS01 : Token da Vila
MBVASCO01 : Vasco Token
MC : Merit Circle
MCO2 : Moss Carbon Credit
MENGOFT : Flamengo
METIS : MetisDAO
MINA : Mina
MIR : Mirror Protocol
MKR : Maker
MPL : Maple
MVI : Metaverse Index
NAVIFT : Natus Vincere
NFT00 : Vale do Outback de 100 reais
NFT10 : Iasy Tata
NFT11 : NFT Feirante Abaetetubense
NFT12 : NFT Facas Feitas
NFT13 : NFT Mandala Yawanawa - Mariri a roda 2
NFT14 : Dodge Dart Sedan 1970 Verde Imperial
NFT15 : Dodge Dart Coupe 1971 Vermelho Etrusco
NFT16 : Dodge Charger LS 1974 White
NFT17 : Dodge Charger LS 1974 Black
NFT18 : Combo de Dodges
NFT19 : Teleton
NFT2 : NFT Protetores da Floresta
NFT20 : Topa tudo por dinheiro
NFT21 : De casa nova
NFT22 : Onde tudo comecou
NFT23 : Matriarca e Patriarca
NFT24 : Surui Riqueza e Autenticidade
NFT25 : Teoria do Caos
NFT26 : Tartarugas do rio Guapore
NFT27 : Viajantes de Asas
NFT28 : Talvez ele toque o ceu
NFT29 : Observador
NFT3 : NFT Protetores da Floresta - Peixe Mandy
NFT30 : Luta
NFT31 : Futuro
NFT32 : Construcao
NFT33 : Protetores da Floresta -Territorio Ancestral
NFT34 : Protetores da Floresta - Protectores de la vida
NFT35 : Protetores da Floresta - Peixe Tucunare
NFT36 : Protetores da Floresta - O que voce come
NFT37 : Protetores da Floresta - 2
NFT38 : Maneva - Album Mundo Novo
NFT39 : Frontispicio #1
NFT4 : NFT Error
NFT40 : Frontispicio #2
NFT41 : Frontispicio #3
NFT42 : Anguereco
NFT43 : Black Angel - #1
NFT44 : Black Angel - #2
NFT45 : Black Angel - #3
NFT46 : Black Angel - #4
NFT47 : Black Angel - #5
NFT48 : Black Angel - #6
NFT49 : Cryptoyabas - #1
NFT5 : NFT Simulation
NFT50 : Cryptoyabas - #2
NFT51 : Cryptoyabas - #3
NFT52 : Cryptoyabas - #4
NFT53 : Cryptoyabas - #5
NFT54 : Cryptoyabas - #6
NFT55 : Cryptoyabas - #7
NFT56 : Cryptoyabas - #8
NFT57 : Cryptoyabas - #9
NFT58 : Um chamado para descentralizacao - #1
NFT59 : Um chamado para descentralizacao - #2
NFT6 : NFT Cosmovisao Tupinamba da Amazonia
NFT60 : Um chamado para descentralizacao - #3
NFT61 : Um chamado para descentralizacao - #4
NFT62 : Um chamado para descentralizacao - #5
NFT63 : Um chamado para descentralizacao - #6
NFT64 : Diva I
NFT65 : Lua Nova em 12 por cento
NFT66 : Lua Crescente em 49 por cento
NFT67 : Desenho de agenda #1
NFT68 : Desenho de agenda #2
NFT69 : Desenho de agenda #3
NFT7 : NFT Barbara Parawara
NFT70 : Luar em 432 hertz
NFT71 : 'Dois mundos unidos pelo amor. Inspirado pelo amor no amor atraves do Metaverso' - Thayllane
NFT72 : 'O Metaverso com personagens da Disney.' - Maria Vitoria
NFT73 : 'O mundo mais doce' - Larissa
NFT74 : 'Meu mini universo, com varios biomas diferentes' - Carlos Eduardo (Cadu)
NFT75 : 'O Multiverso da Nike' - Luiz
NFT76 : 'Um Metaverso repleto de novos amigos' - Thomaz
NFT77 : 'Metanimal: O mundo dos animais.' - Davi Batista
NFT78 : 'O Metaverso colorido e divertido' - Rebeca Maria
NFT79 : 'Um mundo novo, atraves dos oculos' - Deivid L.
NFT8 : NFT Liberdade de sentir
NFT80 : 'Um mundo colorido, onde a alegria nao acaba' - Ana Julia
NFT81 : 'Metaverso do PS3, se voce chegar na arvore, voce ganha todos' Daniel Batista
NFT82 : 'Metaverso com muitas brincadeiras' Marcos Pedro
NFT83 : 'Metadoce, o mundo dos doces' Ana Bela
NFT84 : 'Um estranho gigante de um mundo distante' Luiz Miguel
NFT85 : 'Uma cidade feliz e outra triste' Anne Elis
NFT86 : 'O mundo em que voce pode ser o que voce quiser' Maikon Freire
NFT87 : 'Um Metaverso com zumbis' Carlos Henrique
NFT88 : 'Um universo com muitos amigos e brincadeiras' Luiz Gustavo
NFT89 : 'Um Metaverso de Minecraft colorido' Pedro Gabriel
NFT9 : NFT Pescaria
NFT91 : NFT.Rio | Exposicao
NFT92 : NFT.Rio | Talks e Masterclass
NFTI : NFT Index
NFTOKN01 : Cesta de NFTs
OCEAN : Ocean Protocol
OGFT : OG eSports
OGN : Origin Protocol
OMG : Omg Network
OP : Optimism
OPUL : Opulous
OXT : Orchid
PAXG : PAX Gold
PERP : Perpetual Protocol
PFLFT : Professional Fighters League
PLA : PlayDapp
POLS : Polkastarter
POLY : Polymath
PORFT : Portugal National Team FT
POWR : Power Ledger
PSGFT : Paris Saint-Germain
QNT : Quant
RACA : Radio Caca
RAD : Radicle
RARE : SuperRare
RARI : Rarible
REN : Ren
REQ : Request
RLY : Rally
RNDR : Render Token
ROSE : Oasis Network
SACI : Sport Club Internacional
SAND : The Sandbox
SAUBERFT : Alfa Romeo Racing ORLEN
SCCPFT : Corinthians
SDAO : SingularityDAO
SHIB : Shiba Inu
SKL : SKALE Network
SLP : Smooth Love Potion
SNX : Synthetix
SOL : Solana
SPELL : Spell Token
SPFCFT : SPFC
SRM : Serum
STG : Stargate FInance
STORJ : Storj
STVFT : Sint-Truidense Voetbalvereniging
STX : Stacks
SUPER : SuperFarm
SUSHI : SushiSwap
SYN : Synapse
THFT : Team Heretics
TLM : Alien Worlds
TRB : Tellor
TRU : TrueFi
UFCFT : UFC
UMA : Uma
UNI : Uniswap
USDC : USD Coin
USDP : Pax Dollar
VERDAO : Sociedade Esportiva Palmeiras
VSPRK01 : Precatorio VS SP01
WBTC : Wrapped Bitcoin
WBX : WiBX
WLUNA : Wrapped LUNA Token
XLM : Stellar
XRP : XRP
XTZ : Tezos
YBOFT : BSC Young Boys
YFI : yearn.finance
YGG : Yield Guild Games
ZRX : 0x
FTBRL : None
method
: Método da API de Dados requisitadoTipo: String
Domínio de dados:ticker : resumo de operações executadas
orderbook : livro de negociações, ordens abertas de compra e venda
trades : histórico de operações executadasRespostas
As Respostas são retornadas no formato JSON.
Exemplo de URL
https://www.mercadobitcoin.net/api/BTC/ticker/
Métodos da API
ticker
Descrição
Retorna informações com o resumo das últimas 24 horas de negociações.
Resultado
high
: Maior preço unitário de negociação das últimas 24 horas.Tipo: Decimallow
: Menor preço unitário de negociação das últimas 24 horas.Tipo: Decimalvol
: Quantidade negociada nas últimas 24 horas.Tipo: Decimallast
: Preço unitário da última negociação.Tipo: Decimalbuy
: Maior preço de oferta de compra das últimas 24 horas.Tipo: Decimalsell
: Menor preço de oferta de venda das últimas 24 horas.Tipo: Decimaldate
: Data e hora da informação em Era UnixTipo: InteiroExemplo de chamada:
https://www.mercadobitcoin.net/api/BTC/ticker/Exemplo de Retorno:
{ 'ticker': { 'high': 14481.47000000, 'low': 13706.00002000, 'vol': 443.73564488, 'last': 14447.01000000, 'buy': 14447.00100000, 'sell': 14447.01000000, 'date': 1502977646 } }
orderbook
Descrição
Livro 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.
Resultado
bids
: Lista de ofertas de compras, ordenadas do maior para o menor preço.Tipo: Array[0]
: Preço unitário da oferta de compra.Tipo: Decimal[1]
: Quantidade da oferta de compra.Tipo: Decimalasks
: Lista de ofertas de venda, ordenadas do menor para o maior preço.Tipo: Array[0]
: Preço unitário da oferta de venda.Tipo: Decimal[1]
: Quantidade da oferta de venda.Tipo: DecimalExemplo de chamada:
https://www.mercadobitcoin.net/api/BTC/orderbook/Exemplo de Retorno
{ "asks": [ [10410.00006000, 2.09190016], [10420.00000000, 0.00997000], [10488.99999000, 0.46634897] ], "bids": [ [10405.38258000, 0.00181000], [10393.84180000, 0.08387000] ] }
trades
Descrição
Histórico de negociações realizadas.
Resultado
[]
: Lista de negociações realizadas.date
: Data e hora da negociação em Era UnixTipo: Decimalprice
: Preço unitário da negociação.Tipo: Decimalamount
: Quantidade da negociação.Tipo: Decimaltid
: Identificador da negociação.Tipo: Inteirotype
: Indica a ponta executora da negociaçãoTipo: String
Domínio de dados:buy : indica ordem de compra executora
sell : indica ordem de venda executoraExemplo de chamada:
https://www.mercadobitcoin.net/api/BTC/trades/Parâmetros adicionais
A chamada tradicional do histórico irá retornar as últimas 1000 negociações. Para obter dados anteriores, é necessário utilizar outros parâmetros conforme descrito e exemplificado abaixo:
tid
ousince
: Retorna até 1000 negociações a partir do identificador da negociação informado.Chamadas:
https://www.mercadobitcoin.net/api/coin
/trades/?tid=<tid>
https://www.mercadobitcoin.net/api/coin
/trades/?since=<since>
Exemplo:https://www.mercadobitcoin.net/api/BTC/trades/?tid=5700 https://www.mercadobitcoin.net/api/BTC/trades/?since=5700
from
: Retorna até 1000 negociações a partir da data informada.Formato: Era Unix
Chamada: https://www.mercadobitcoin.net/api/coin
/trades/<from>
/
Exemplo:https://www.mercadobitcoin.net/api/BTC/trades/1501871369/
from
-to
: Retorna até 1000 negociações entre o intervalo de timestamp informado.Formato: Era Unix
Chamada: https://www.mercadobitcoin.net/api/coin
/trades/<from>
/<to>
/
Exemplo:https://www.mercadobitcoin.net/api/BTC/trades/1501871369/1501891200/
Exemplo de Retorno
[ { 'date': 1502993741, 'price': 14086.00000000, 'amount': 0.03840000, 'tid': 797861, 'type': 'sell' }, { 'date': 1502993741, 'price': 14086.00101000, 'amount': 0.08519000, 'tid': 797860, 'type': 'sell' }, { 'date': 1502993907, 'price': 14200.00000000, 'amount': 0.01370282, 'tid': 797871, 'type': 'buy' }, { 'date': 1502993898, 'price': 14200.00000000, 'amount': 0.00697183, 'tid': 797870, 'type': 'buy' }, { 'date': 1502982896, 'price': 14320.00101000, 'amount': 0.02089000, 'tid': 796876, 'type': 'sell' } ]
day-summary
Descrição
Retorna resumo diário de negociações realizadas.
Resultado
date
: Data do resumo diárioTipo: String
Formato: AAAA-MM-DD, exemplo: 2013-06-20opening
: Preço unitário de abertura de negociação no dia.Tipo: Decimalclosing
: Preço unitário de fechamento de negociação no dia.Tipo: Decimallowest
: Menor preço unitário de negociação no dia.Tipo: Decimalhighest
: Maior preço unitário de negociação no dia.Tipo: Decimalvolume
: Volume de Reais (BRL) negociados no dia.Tipo: Decimalquantity
: Quantidade da moeda digital negociada no dia.Tipo: Decimalamount
: Número de negociações realizadas no dia.Tipo: Inteiroavg_price
: Preço unitário médio das negociações no dia.Tipo: DecimalParâmetros adicionais
year
,month
,day
: Respectivamente ano, mês e dia referente ao dia do ano requisitado.Chamadas:
https://www.mercadobitcoin.net/api/coin
/day-summary/<year>
/<month>
/<day>
/
Exemplo:https://www.mercadobitcoin.net/api/BTC/day-summary/2013/6/20/
Exemplo de Retorno
{ 'date': '2013-06-20', 'opening': 262.99999, 'closing': 269.0, 'lowest': 260.00002, 'highest': 269.0, 'volume': 7253.1336356785, 'quantity': 27.11390588, 'amount': 28, 'avg_price': 267.5060416518087 }
Glossário
API - Conjunto de rotinas e padrões para acesso a um aplicativo ou plataforma, leia mais em: https://en.wikipedia.org/wiki/Application_programming_interface.
CORS (Cross-Origin Resource Sharing) - Em termos práticos, é um recurso de segurança dos navegadores que impede um domínio de fazer requisições Ajax de um outro domínio, a não ser que seja explicitamente pelo domínio de origem da informação, leia mais em: https://en.wikipedia.org/wiki/Cross-origin_resource_sharing
Domínio de dados - Conjunto de valores possíveis para um determinado campo, leia mais em: https://en.wikipedia.org/wiki/Data_domain.
Era Unix - Sistema de calendário utilizado pelo sistema operacional UNIX representado por um número inteiro de até 32 bits. É útil para comunicação e cálculos em sistemas devido a sua simplicidade. Seus valores representam a quantidade de segundos a partir do dia 1 de janeiro de 1970. É um horário sem variações de fuso horário ou horário de verão, assim utiliza apenas UTC/GMT, leia mais em: https://pt.wikipedia.org/wiki/Era_Unix. Veja exemplos de código em diversas linguagens em: http://www.epochconverter.com.
JSON - Formato leve para intercâmbio de dados computacionais, leia mais em: https://pt.wikipedia.org/wiki/JSON.
String - Tipo de dado texto, cadeia de caracteres, leia mais em: https://en.wikipedia.org/wiki/String_(computer_science).