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_USDTDados 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.
