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 digital
Tipo: 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 requisitado
Tipo: 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 executadas

Respostas

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: Decimal
 low: Menor preço unitário de negociação das últimas 24 horas.
Tipo: Decimal
 vol: Quantidade negociada nas últimas 24 horas.
Tipo: Decimal
 last: Preço unitário da última negociação.
Tipo: Decimal
 buy: Maior preço de oferta de compra das últimas 24 horas.
Tipo: Decimal
 sell: Menor preço de oferta de venda das últimas 24 horas.
Tipo: Decimal
 date: Data e hora da informação em Era Unix
Tipo: Inteiro
Exemplo 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: Decimal
 asks: 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: Decimal
Exemplo 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 Unix
Tipo: Decimal
price: Preço unitário da negociação.
Tipo: Decimal
amount: Quantidade da negociação.
Tipo: Decimal
tid: Identificador da negociação.
Tipo: Inteiro
type: Indica a ponta executora da negociação
Tipo: String
Domínio de dados:
buy : indica ordem de compra executora
sell : indica ordem de venda executora
Exemplo 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 ou since: 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ário
Tipo: String
Formato: AAAA-MM-DD, exemplo: 2013-06-20
opening: Preço unitário de abertura de negociação no dia.
Tipo: Decimal
closing: Preço unitário de fechamento de negociação no dia.
Tipo: Decimal
lowest: Menor preço unitário de negociação no dia.
Tipo: Decimal
highest: Maior preço unitário de negociação no dia.
Tipo: Decimal
volume: Volume de Reais (BRL) negociados no dia.
Tipo: Decimal
quantity: Quantidade da moeda digital negociada no dia.
Tipo: Decimal
amount: Número de negociações realizadas no dia.
Tipo: Inteiro
avg_price: Preço unitário médio das negociações no dia.
Tipo: Decimal
Parâ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).