> ## Documentation Index
> Fetch the complete documentation index at: https://developer.liquiditi.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Ativo

> O objeto Asset (`asset`) nas respostas da API e na tela de ordens — identificação do título e dados complementares.

## Visão geral

Na plataforma, cada ordem se refere a um **título** (CDB, LCI, LCA etc.). Na API, os dados desse título aparecem no objeto **`asset`** (esquema **Asset**).

<h2 id="campos-asset">Campos do objeto `asset`</h2>

A tabela abaixo reflete o que a API expõe no objeto **`asset`**. Tipos e formatos seguem o contrato em uso (OpenAPI em [Referência da API](/api-reference/introduction)).

| Campo (API)                | Tipo            | Descrição                                                                                      |
| -------------------------- | --------------- | ---------------------------------------------------------------------------------------------- |
| `id`                       | `string` (UUID) | Identificador único do ativo na Liquiditi                                                      |
| `type`                     | `string`        | Tipo do título. Valores: enum **AssetType** (tabela abaixo)                                    |
| `name`                     | `string`        | Nome do ativo                                                                                  |
| `cetip_code`               | `string`        | Código do título na CETIP (alinha com `asset_code` na ordem)                                   |
| `maturity_date`            | `string` (data) | Data de vencimento (`YYYY-MM-DD`)                                                              |
| `grace_date`               | `string` (data) | Data de carência (`YYYY-MM-DD`)                                                                |
| `redemption_type`          | `string`        | Tipo de resgate do **principal** (valores dependem do contrato exposto pela API)               |
| `interest_redemption_type` | `string`        | Periodicidade ou forma de resgate dos **juros**. Valores: enum **AssetInterestRedemptionType** |

### Indexação e rentabilidade

A **indexação** descreve em que indicador o título se ancora (por exemplo CDI ou IPCA). No livro de ofertas e nas ordens, esse dado aparece em **`asset.asset_indexer`** e segue os valores do enum **AssetIndexer** (tabela nesta página, na seção de enums).

A **rentabilidade** no objeto **`asset`** é decomposta em dois campos decimais (sempre **string** no JSON), que a API preenche conforme o tipo de estrutura:

* **`percentage_yield`** — parcela **pós-fixada** em relação ao indexador, expressa como fração do indicador (por exemplo `"1.0"` para 100% do CDI). Use quando a remuneração é um múltiplo do indexador **sem** spread prefixado explícito sobre o indicador.
* **`prefixed_yield`** — parcela **prefixada** ou **spread** sobre o indexador, em decimal (por exemplo `"0.02"` para dois pontos percentuais ao ano quando a estrutura for “indicador + spread”). Use quando há taxa prefixada ou acréscimo fixo sobre o indexador.

Em resumo: títulos **só pós-fixados** em relação ao indicador tendem a preencher `percentage_yield` e deixar `prefixed_yield` como `null`. Estruturas **indicador + spread** (ou parcela prefixada relevante) tendem a preencher `prefixed_yield` e podem deixar `percentage_yield` como `null` quando a API representa a rentabilidade dessa forma.

Por exemplo, um título que rende 100% do CDI e não tem spread sobre o indicador, terá `percentage_yield` como `"1.0"` e `prefixed_yield` como `null`. Já um título que rende CDI + 2% (spread sobre o indicador), terá `prefixed_yield` como `"0.02"` e `percentage_yield` como `null`.

Para convenções de datas e valores numéricos na API, veja [Definições](/api-reference/definicoes).

<h2 id="enums-ativo">Valores enumerados retornados pela API</h2>

Os valores abaixo são os serializados em JSON (como a API devolve nas strings dos campos indicados).

### Tipo de um ativo (`AssetType`)

| Valor JSON | Significado                              |
| ---------- | ---------------------------------------- |
| `CDB`      | Certificado de depósito bancário         |
| `LCI`      | Letra de crédito imobiliário             |
| `LCA`      | Letra de crédito do agronegócio          |
| `LCD`      | Letra de crédito de desenvolvimento      |
| `LF`       | Letra financeira                         |
| `CRI`      | Certificado de recebíveis imobiliários   |
| `CRA`      | Certificado de recebíveis do agronegócio |
| `DEB`      | Debênture                                |

### Indexador de um ativo (`AssetIndexer`)

| Valor JSON | Significado |
| ---------- | ----------- |
| `CDI`      | CDI         |
| `IPCA`     | IPCA        |

<Tip>
  O indexador aparece em **`asset.asset_indexer`** nas respostas de ofertas e ordens. Use esta mesma tabela de valores.
</Tip>

### Tipo de resgate do principal (`AssetRedemptionType`)

| Valor JSON    | Descrição                                   |
| ------------- | ------------------------------------------- |
| `at_maturity` | Principal pago ou incorporado no vencimento |
| `daily`       | Fluxo de principal com periodicidade diária |
| `monthly`     | Fluxo de principal com periodicidade mensal |
| `yearly`      | Fluxo de principal com periodicidade anual  |
| `unknown`     | Não informado ou não classificado           |

### Tipo de resgate dos juros (`AssetInterestRedemptionType`)

| Valor JSON    | Descrição                                 |
| ------------- | ----------------------------------------- |
| `at_maturity` | Juros pagos ou incorporados no vencimento |
| `daily`       | Fluxo de juros com periodicidade diária   |
| `monthly`     | Fluxo de juros com periodicidade mensal   |
| `yearly`      | Fluxo de juros com periodicidade anual    |
| `unknown`     | Não informado ou não classificado         |

## Via API

Respostas **Order** e **Ask** incluem `asset_type`, `asset_code` (CETIP) e o objeto aninhado **`asset`** com os mesmos campos de identificação e condições do título (`asset_indexer`, `interest_redemption_type`, `redemption_type` etc.).

<CardGroup cols={2}>
  <Card title="Detalhes de um ativo" icon="layer-group" href="/api-reference/endpoint/detalhes-ativo">
    `GET /assets/{id}` — detalhes de um ativo específico pelo identificador.
  </Card>

  <Card title="Listar ofertas" icon="book-open" href="/api-reference/endpoint/listar-ofertas">
    `GET /asks` — lista de ofertas com filtros por tipo, indexador e vencimento.
  </Card>
</CardGroup>