API de Dados | Mercado Bitcoin

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
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
CTSI : Cartesi
CVC : Civic
CVX : Convex Finance
DAI : Dai
DG : Decentral Games
DIA : DIA
DOGE : Dogecoin
DOT : Polkadot
DPI : DeFi Pulse Index
DYDX : dYdX
ENJ : Enjin Coin
ENS : Ethereum Name Service
ETH : Ethereum
FARM : Harvest Finance
FET : Fetch.ai
FIL : Filecoin
FLOKI : Floki Inu
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
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 : None
MBFP04 : None
MBFP05 : None
MBFP06 : Fluxos de Pagamento 06
MBFP07 : Fluxos de Pagamento 07
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
NFT4 : NFT Error
NFT5 : NFT Simulation
NFT6 : NFT Cosmovisao Tupinamba da Amazonia
NFT7 : NFT Barbara Parawara
NFT8 : NFT Liberdade de sentir
NFT9 : NFT Pescaria
NFTI : NFT Index
NFTOKN01 : Cesta de NFTs
OCEAN : Ocean Protocol
OGFT : OG eSports
OGN : Origin Protocol
OMG : Omg Network
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).

API de Dados v3

Acesso à API de Dados

Estrutura das Requisições

URL

Parâmetros de URL

Respostas

Exemplo de URL

Métodos da API

ticker

Descrição

Resultado

Exemplo de chamada:

Exemplo de Retorno:

orderbook

Descrição

Resultado

Exemplo de chamada:

Exemplo de Retorno

trades

Descrição

Resultado

Exemplo de chamada:

Parâmetros adicionais

Exemplo de Retorno

day-summary

Descrição

Resultado

Parâmetros adicionais

Exemplo de Retorno

Glossário