Public APINo Auth

Contratos XDC

Dados em tempo real de ~1.800 tokens tokenizados na XDC Network. Retorna endereços blockchain, preços, métricas de investidores, dados de lastro e status de captação. Respostas cacheadas por 4 minutos.

Acesso Público

Estes endpoints são públicos e não requerem autenticação. A única limitação é o rate limit de 30 requisições por minuto por IP.

Cache e Performance

A resposta é cacheada por 4 minutos no servidor. A primeira requisição após expirar o cache leva ~17s. Requisições subsequentes são instantâneas. O default é 200 itens por página — itere com offset para buscar todos.

Listar Tokens

GET/api/v1/blockchain/xdc/contracts/latest

Retorna lista paginada de todos os tokens tokenizados na XDC Network. Quando symbol é informado, retorna item único.

Query Parameters

Name	Type	Required	Description
`symbol`	string	Optional	Filtrar por ticker (case-insensitive). Retorna objeto direto, sem wrapper items/pagination.
`limit`	integer	Optional	Itens por página (1 a 1000).(default: `200`)
`offset`	integer	Optional	Offset para paginação.(default: `0`)

Resposta (lista)

Retorna items com os tokens e pagination para navegar. Itere enquanto hasMore === true.

Resposta (symbol específico)

Retorna o objeto do token diretamente (sem wrapper). Se não encontrado, retorna { "message": "Token not found" }.

Tokens por Data

GET/api/v1/blockchain/xdc/contracts/by-date/:date

Retorna estado atual dos tokens. Suporta paginação via nextToken.

Path Parameters

Name	Type	Required	Description
`date`	string	Required	Data no formato YYYY-MM-DD.

Query Parameters

Name	Type	Required	Description
`limit`	integer	Optional	Itens por página (1 a 1000).(default: `200`)
`nextToken`	string	Optional	Token base64 da resposta anterior. Quando null, não há mais páginas.

Campos da Resposta

Identificação

Campo	Tipo	Descrição
tokenSymbol	string	Ticker (ex: ROB1SR01)
tokenName	string	Nome do patrimônio
originator	string\|null	Nome do originador
assetType	string\|null	Tipo de ativo (CR, CRA, CRI, Debenture, Nota Fiscal, CCB)
trancheClass	string\|null	SENIOR, MEZZANINE, JUNIOR ou UNIQUE
legacy	boolean	true = plataforma v1, false = plataforma atual

Blockchain

Campo	Tipo	Descrição
trancheAddress	string	Endereço do contrato da tranche
contractAddress	string	Endereço do TIDC (patrimônio)
offeringManagerAddress	string	OfferingManager address
network	string	Sempre "XDC"
transfersCount	number	Transferências on-chain (primário + secundário)

Financeiro

Campo	Tipo	Descrição
priceBrl / priceUsd	string	Preço unitário em BRL e USD
totalValueBrl / totalValueUsd	string	Valor total da oferta
marketCapBrl / marketCapUsd	string	Market cap (soldTokens × price)
apy	string	Rendimento anual (%)
indicatorType	string	PRE_FIXED, CDI ou USD
holdersOnchain	string	Número de holders on-chain
fundraisingStatus	string	"open" (captando) ou "closed" (encerrado)

Paginação

O endpoint /latest usa limit + offset. O endpoint /by-date usa nextToken (base64).

Campo	Tipo	Descrição
pagination.total	integer	Total de tokens disponíveis
pagination.offset	integer	Offset atual
pagination.limit	integer	Tamanho da página
pagination.hasMore	boolean	true se existem mais páginas

Rate Limiting

Limite	Valor
Requisições por minuto	30 por IP
Limite máximo por página	1000 itens
Cache server-side	4 minutos

Recomendação

Com o cache de 4 minutos e limit=500, você busca todos os ~1.800 tokens em 4 requests instantâneas. Apenas a primeira request (cold cache) leva mais tempo.

Listar Tokens (paginado)

cURL

curl -X GET "https://api.liqi.com.br/blockchain/xdc/contracts/latest?limit=500&offset=0" \
  -H "Accept: application/json"

TypeScript

// buscar todos os tokens iterando páginas
const allTokens = [];
let offset = 0;
const limit = 500;

while (true) {
  const res = await fetch(
    `https://api.liqi.com.br/blockchain/xdc/contracts/latest?limit=${limit}&offset=${offset}`
  );
  const data = await res.json();

  allTokens.push(...data.items);

  if (!data.pagination.hasMore) break;
  offset += limit;
}

console.log(`Total: ${allTokens.length} tokens`);

200Lista paginada de tokens

{
  "items": [
    {
      "tokenSymbol": "ROB1SR01",
      "tokenName": "Robbin 01",
      "trancheAddress": "0x56B638e3Bbd6...",
      "contractAddress": "0x67b4F28F6215...",
      "network": "XDC",
      "priceBrl": "25.00",
      "priceUsd": "4.839803",
      "totalValueBrl": "500000.00",
      "marketCapBrl": "500000.00",
      "apy": "18.15",
      "indicatorType": "PRE_FIXED",
      "trancheClass": "SENIOR",
      "fundraisingStatus": "closed",
      "assetType": "CR",
      "legacy": false,
      "transfersCount": 85,
      "holdersOnchain": "81",
      "maturityDate": "2026-01-06",
      "originator": "Robbin Pagamentos LTDA",
      "legislation": "RCVM 88"
    }
  ],
  "count": 200,
  "date": "2026-04-08",
  "pagination": {
    "total": 1806,
    "offset": 0,
    "limit": 200,
    "hasMore": true
  }
}

Token Específico

cURL

curl -X GET "https://api.liqi.com.br/blockchain/xdc/contracts/latest?symbol=ROB1SR01"

200Token individual (retorna objeto direto)

{
  "tokenSymbol": "ROB1SR01",
  "tokenName": "Robbin 01",
  "trancheAddress": "0x56B638e3...",
  "network": "XDC",
  "priceBrl": "25.00",
  "assetType": "CR",
  "legacy": false,
  "transfersCount": 85,
  "...": "demais campos"
}

Por Data (com nextToken)

cURL

curl -X GET "https://api.liqi.com.br/blockchain/xdc/contracts/by-date/2026-04-08?limit=500"

200Tokens com paginação via nextToken

{
  "items": [
    "..."
  ],
  "count": 500,
  "total": 1806,
  "date": "2026-04-08",
  "nextToken": "eyJvZmZzZXQiOjUwMH0="
}

Respostas de Erro

200Token não encontrado

{
  "message": "Token not found"
}

200Token sem contrato deployado

{
  "message": "Token exists but blockchain contract is not yet deployed"
}

429Rate limit excedido

{
  "statusCode": 429,
  "message": "ThrottlerException: Too Many Requests"
}