Desenvolvedores

API pública de dados de mercado

Preços, candles, livro de ofertas e lista de pares. Sem cadastro, sem chave e gratuita.

Início rápido

URL base: https://yubbit.com/api/v1

Autenticação: Não necessária

curl https://yubbit.com/api/v1/ticker?symbol=BTC_USDT

Dados de mercado

Formato próprio da Yubbit: preços em tempo real, candles e livro de ordens de um par ou de todos os pares.

GET /api/v1/ping

Verificação da saúde do serviço.

GET /api/v1/time

Relógio do servidor, para assinatura ou verificação de desvios.

GET /api/v1/markets

Preço em tempo real e estatísticas de 24 h para todos os pares.

GET /api/v1/ticker?symbol=

Preço em tempo real de um par. Sem símbolo, este endpoint retorna todos os pares spot no formato CoinMarketCap (consulte a seção spot).

GET /api/v1/klines

Candles OHLCV, do mais antigo ao mais recente. open_time é o horário de abertura do candle em segundos Unix, não em milissegundos.

GET /api/v1/orderbook?symbol=

Instantâneo do livro de ordens. As bids vão do melhor preço (mais alto) para baixo; as asks vão do melhor preço (mais baixo) para cima. Cada nível é [preço, quantidade]. best_ask / best_bid são os preços pelos quais uma compra / venda a mercado é executada.

Spot: formato CoinMarketCap

Endpoints do mercado spot que seguem a especificação de listagem de exchanges da CoinMarketCap: resumo, ativos, ticker, livro de ordens e negociações.

GET /api/v1/summary

Visão geral de 24 horas de todos os pares spot (resumo CoinMarketCap). lowest_ask e highest_bid são os melhores preços no livro de ordens, os preços pelos quais uma compra ou venda a mercado é executada.

GET /api/v1/assets

Todas as moedas negociadas no mercado spot, identificadas pelo símbolo (CoinMarketCap A1). Os campos opcionais aparecem apenas quando a Yubbit tem os dados: name, can_withdraw (false durante a manutenção), min_withdraw (somente USDT), maker_fee, taker_fee e contractAddress.

GET /api/v1/ticker

Último preço e volume de 24 horas de todos os pares spot, identificados por BASE_QUOTE (CoinMarketCap A2). isFrozen é 1 enquanto as negociações estiverem pausadas para manutenção; caso contrário, é 0.

GET /api/v1/orderbook/{market_pair}

Livro de ordens de nível 2 de um par (CoinMarketCap A3). Cada nível é [preço, quantidade].

GET /api/v1/trades/{market_pair}

Negociações spot recentes de um par nas últimas 24 horas.

Derivativos: formato CoinMarketCap

Contratos perpétuos no formato de derivativos da CoinMarketCap: contratos, especificações dos contratos e livro de ordens.

GET /api/v1/contracts

Todos os contratos perpétuos com preço, volume de 24 horas, melhor oferta de compra e venda, interesse em aberto, taxas e especificações do contrato (CoinMarketCap B1, incluindo os campos B2).

GET /api/v1/contract_specs

Especificação do contrato por ticker_id (CoinMarketCap B2). Os contratos são lineares (Vanilla): um contrato equivale a uma unidade da moeda base, com preço e liquidação na moeda de cotação.

GET /api/v1/orderbook/{ticker_id}

Livro de ordens de um contrato perpétuo (CoinMarketCap B3). Aceita os mesmos parâmetros de profundidade e nível que o livro de ordens spot.

O que você precisa saber

  • O Yubbit.com pode reduzir a velocidade de transmissão de dados quando necessário.
  • Esta API é somente de leitura. Ela não expõe dados de conta, saldo ou ordens e não pode executar negociações.
  • O limite de requisições é por IP. Excedê-lo retorna o código 429 com um cabeçalho Retry-After.
  • Os endpoints mantêm compatibilidade com versões anteriores; uma alteração incompatível seria versionada como /api/v2.