CaaS API

Crypto as a Service — trading, carteiras, mercados e cotações RFQ.

Base URL: https://caas.liqi.com.br

Info

A API CaaS usa autenticação JWT (EdDSA). Obtenha um token via POST /v1/auth/login usando suas credenciais apiKey + secretKey.

Autenticação

POST/v1/auth/login

Autentica com apiKey + secretKey e retorna token JWT.

Name	Type	Required	Description
`apiKey`	string	Required	Chave de API fornecida pela Liqi.
`secretKey`	string	Required	Chave secreta pareada com a apiKey.

PUT/v1/auth/refresh

Renova o token JWT usando o refresh token.

Carteiras (Wallets)

GET/v1/wallet/fetchBalance

Retorna saldos consolidados da carteira em todos os ativos.

GET/v1/wallet/fetchDepositAddress

Retorna endereços de depósito para cada rede suportada.

POST/v1/wallet/withdraw

Solicita saque de criptoativo para endereço externo.

Name	Type	Required	Description
`asset`	string	Required	Ativo a ser sacado (ex: BTC, ETH, USDC).
`amount`	string	Required	Quantidade a ser sacada.
`address`	string	Required	Endereço de destino na blockchain.
`network`	string	Optional	Rede (ex: ethereum, polygon). Default depende do ativo.

Mercados (Markets)

GET/v1/market/fetchMarkets

Lista todos os pares de negociação disponíveis.

GET/v1/market/fetchTicker

Retorna dados de preço em tempo real para um par.

Name	Type	Required	Description
`symbol`	string	Required	Par de negociação (ex: BTC/BRL).

GET/v1/market/fetchHistoricalPrices

Retorna preços históricos com intervalos configuráveis.

Name	Type	Required	Description
`symbol`	string	Required	Par de negociação.
`interval`	string	Optional	Intervalo: 1h, 4h, 1d, 1w.(default: `1d`)
`limit`	number	Optional	Número de candles.(default: `30`)

Ordens (Orders)

POST/v1/orders/createOrder

Cria uma nova ordem de compra ou venda.

Name	Type	Required	Description
`symbol`	string	Required	Par de negociação (ex: BTC/BRL).
`side`	string	Required	Lado da ordem: BUY ou SELL.
`type`	string	Required	Tipo: MARKET ou LIMIT.
`amount`	string	Required	Quantidade do ativo base.
`price`	string	Optional	Preço limite (obrigatório para ordens LIMIT).

GET/v1/orders/fetchOrders

Lista ordens com filtros opcionais.

Name	Type	Required	Description
`symbol`	string	Optional	Filtrar por par.
`status`	string	Optional	OPEN, FILLED, CANCELLED, EXPIRED.
`limit`	number	Optional	Itens por página.(default: `50`)

DELETE/v1/orders/cancelOrder

Cancela uma ordem aberta.

RFQ (Request for Quote)

O fluxo RFQ permite obter uma cotação garantida por 30 segundos antes de executar. Ideal para grandes volumes ou quando preço fixo é necessário.

POST/v1/orders/rfq/createQuote

Solicita uma cotação de preço fixo. Validade de 30 segundos.

Name	Type	Required	Description
`symbol`	string	Required	Par de negociação.
`side`	string	Required	BUY ou SELL.
`amount`	string	Required	Quantidade do ativo base.

POST/v1/orders/rfq/executeQuote

Executa uma cotação RFQ antes da expiração.

WebSockets

Conecte-se ao WebSocket para receber atualizações em tempo real de preços, ordens e saldos.

Info

WebSocket URL: wss://caas.liqi.com.br/ws. Autentique enviando o token JWT na mensagem de subscribe.

Canais disponíveis

Canal	Descrição
`ticker:{symbol}`	Precos em tempo real.
`orders`	Atualizações de status de ordens.
`balance`	Atualizações de saldo da carteira.

Ambientes

Ambiente	URL	Dados
Produção	`https://caas.liqi.com.br`	Dados reais, ordens executadas em exchanges.
Sandbox	`https://sandbox.caas.liqi.com.br`	Dados sintéticos (header X-Synthetic).

Autenticação JWT

cURL - Login

curl -X POST https://caas.liqi.com.br/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "your-api-key",
    "secretKey": "your-secret-key"
  }'

# Response:
# {
#   "token": "eyJhbGciOiJFZERTQSIs...",
#   "refreshToken": "eyJhbGciOiJFZERTQSIs...",
#   "expiresIn": 3600
# }

Listar mercados

cURL - Mercados

curl https://caas.liqi.com.br/v1/market/fetchMarkets \
  -H "Authorization: Bearer eyJhbGciOiJFZERTQSIs..."

Response - Mercados

200Success

{
  "markets": [
    {
      "symbol": "BTC/BRL",
      "base": "BTC",
      "quote": "BRL",
      "active": true,
      "minAmount": "0.00001",
      "maxAmount": "10.0",
      "pricePrecision": 2,
      "amountPrecision": 8
    },
    {
      "symbol": "ETH/BRL",
      "base": "ETH",
      "quote": "BRL",
      "active": true,
      "minAmount": "0.0001",
      "maxAmount": "100.0",
      "pricePrecision": 2,
      "amountPrecision": 8
    },
    {
      "symbol": "USDC/BRL",
      "base": "USDC",
      "quote": "BRL",
      "active": true,
      "minAmount": "1.0",
      "maxAmount": "1000000.0",
      "pricePrecision": 4,
      "amountPrecision": 2
    }
  ]
}

Criar ordem

cURL - Criar ordem

curl -X POST https://caas.liqi.com.br/v1/orders/createOrder \
  -H "Authorization: Bearer eyJhbGciOiJFZERTQSIs..." \
  -H "Content-Type: application/json" \
  -d '{
    "symbol": "BTC/BRL",
    "side": "BUY",
    "type": "MARKET",
    "amount": "0.001"
  }'

RFQ (Request for Quote)

cURL - Fluxo RFQ

// 1. Solicitar cotação
curl -X POST https://caas.liqi.com.br/v1/orders/rfq/createQuote \
  -H "Authorization: Bearer ..." \
  -d '{ "symbol": "BTC/BRL", "side": "BUY", "amount": "0.5" }'

// Response: { "quoteId": "...", "price": "350000.00", "expiresAt": "..." }

// 2. Executar cotação (dentro de 30s)
curl -X POST https://caas.liqi.com.br/v1/orders/rfq/executeQuote \
  -H "Authorization: Bearer ..." \
  -d '{ "quoteId": "quote-uuid" }'