O esquema Asset e os dados do título nas respostas da API — identificação por cetip_code.
Visão geral
Na plataforma, cada ordem se refere a um título (CDB, LCI, LCA etc.). O identificador público do título na API é o cetip_code. Consulte um ativo com GET /assets/{cetip_code}.Nas ofertas, os dados do título vêm em campos no próprio Ask (name, cetip_code, asset_type, asset_indexer etc.). Nas ordens, o resumo do título está em metadata (asset_name, maturity_date, issuer), além de asset_code e asset_type no topo.
Campos do esquema Asset
A tabela abaixo reflete o que a API expõe em GET /assets/{cetip_code}. Tipos e formatos seguem o contrato em uso (OpenAPI em Referência da API).cetip_code deve ser alfanumérico, com 1 a 64 caracteres (^[A-Za-z0-9]{1,64}$). Um UUID ou qualquer outro valor fora desse padrão retorna 422 e não é encaminhado.
Campo (API)
Tipo
Descrição
id
string (UUID)
Identificador interno do ativo
name
string
Nome do título
cetip_code
string
Código do título na CETIP — identificador público (alinha com asset_code na ordem)
asset_type
string
Tipo do título. Valores: enum AssetType (tabela abaixo)
asset_indexer
string
Indexador do título. Valores: enum AssetIndexer
maturity_date
string (data)
Data de vencimento (YYYY-MM-DD)
grace_date
string (data)
Data de carência (YYYY-MM-DD)
interest_redemption_type
string
Periodicidade ou forma de resgate dos juros. Valores: enum AssetInterestRedemptionType
redemption_type
string
Tipo de resgate do principal. Valores: enum AssetRedemptionType
issuer_name
string
Nome do emissor
issuing_date
string (data)
Data de emissão (YYYY-MM-DD)
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 esse dado aparece em asset_indexer e segue os valores do enum AssetIndexer.A rentabilidade da oferta está nos campos do Ask (sempre string no JSON, ou null):
ask_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.
ask_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 ask_percentage_yield e deixar ask_prefixed_yield como null. Estruturas indicador + spread (ou parcela prefixada relevante) tendem a preencher ask_prefixed_yield e podem deixar ask_percentage_yield como null.Por exemplo, um título que rende 100% do CDI e não tem spread sobre o indicador terá ask_percentage_yield como "1.0" e ask_prefixed_yield como null. Já um título que rende CDI + 2% terá ask_prefixed_yield como "0.02" e ask_percentage_yield como null.O endpoint de ativo não devolve campos de rentabilidade. Para convenções de datas e valores numéricos, veja Definições.
Valores enumerados retornados pela API
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
O indexador aparece em asset_indexer nas respostas de ofertas e de ativo. Use esta mesma tabela de valores.
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
Consulte o título pelo cetip_code. Nas ofertas, os mesmos enums aparecem em campos flat do Ask. Nas ordens, use asset_code, asset_type e metadata. O PDF CETIP é baixado pela ordem: Baixar arquivo CETIP.
Detalhes de um ativo
GET /assets/{cetip_code} — detalhes de um ativo pelo código CETIP.
Listar ofertas
GET /asks — lista de ofertas com filtros por tipo, indexador, vencimento e código CETIP.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Liquiditi","colors":{"primary":"#16A34A","light":"#07C983","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/liquiditi/40kYDMt7UMG66RqF/logo/logo.svg?fit=max\u0026auto=format\u0026n=40kYDMt7UMG66RqF\u0026q=85\u0026s=3e7f35a6d4b189758857f786c6883dea","dark":"https://mintcdn.com/liquiditi/40kYDMt7UMG66RqF/logo/logo-white.svg?fit=max\u0026auto=format\u0026n=40kYDMt7UMG66RqF\u0026q=85\u0026s=7b352883100f7edfa46ce52eb3ef6e43"},"favicon":{"light":"https://mintcdn.com/liquiditi/S3U1z6RR0thnfFwz/favicon.svg?fit=max\u0026auto=format\u0026n=S3U1z6RR0thnfFwz\u0026q=85\u0026s=19ead661e45d6c7609613854da3d4475","dark":"https://mintcdn.com/liquiditi/S3U1z6RR0thnfFwz/favicon-white.svg?fit=max\u0026auto=format\u0026n=S3U1z6RR0thnfFwz\u0026q=85\u0026s=6f4c821905978b2062a8ce28c24b5d86"},"navbar":{"links":[{"href":"mailto:suporte@liquiditi.com.br","label":"Suporte"}]},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/liquiditiltda"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Acessar plataforma","icon":"up-right-from-square","href":"https://app.liquiditi.com.br"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"liquiditi","hasAudioNarration":false,"actualSubdomain":"liquiditi","customDomains":["developer.liquiditi.com.br"],"gitSource":{"type":"github","owner":"liquiditi","repo":"mintlify-docs","deployBranch":"main","isPrivate":true,"contentDirectory":"","mountPath":"","label":""},"entitlements":{},"buildId":"6ac66d9bd48175c8c311e528","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"Referência da API","count":10},{"language":"default","tag":"Documentação","count":5},{"language":"default","tag":"Ordens","count":4},{"language":"default","tag":"Visão geral","count":3},{"language":"default","tag":"Plataforma","count":3},{"language":"default","tag":"Começando","count":2},{"language":"default","tag":"Renda Fixa","count":2},{"language":"default","tag":"Ativos","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"ativo","slug":"/ativo","pageMetadata":{"title":"Ativo","description":"O esquema Asset e os dados do título nas respostas da API — identificação por cetip_code.","href":"/ativo"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"O esquema Asset e os dados do título nas respostas da API — identificação por cetip_code.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Card,CardGroup,Heading,Table,Tip}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`visão-geral`,children:`Visão geral`}),`\n`,_jsxs(_components.p,{children:[`Na plataforma, cada ordem se refere a um `,_jsx(_components.strong,{children:`título`}),` (CDB, LCI, LCA etc.). O identificador público do título na API é o `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`cetip_code`})}),`. Consulte um ativo com `,_jsx(_components.code,{children:`GET /assets/{cetip_code}`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Nas ofertas, os dados do título vêm em campos no próprio `,_jsx(_components.strong,{children:`Ask`}),` (`,_jsx(_components.code,{children:`name`}),`, `,_jsx(_components.code,{children:`cetip_code`}),`, `,_jsx(_components.code,{children:`asset_type`}),`, `,_jsx(_components.code,{children:`asset_indexer`}),` etc.). Nas ordens, o resumo do título está em `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`metadata`})}),` (`,_jsx(_components.code,{children:`asset_name`}),`, `,_jsx(_components.code,{children:`maturity_date`}),`, `,_jsx(_components.code,{children:`issuer`}),`), além de `,_jsx(_components.code,{children:`asset_code`}),` e `,_jsx(_components.code,{children:`asset_type`}),` no topo.`]}),`\n`,_jsx(Heading,{level:`2`,id:`campos-asset`,children:`Campos do esquema Asset`}),`\n`,_jsxs(_components.p,{children:[`A tabela abaixo reflete o que a API expõe em `,_jsx(_components.code,{children:`GET /assets/{cetip_code}`}),`. Tipos e formatos seguem o contrato em uso (OpenAPI em `,_jsx(_components.a,{href:`/api-reference/introduction`,children:`Referência da API`}),`).`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`cetip_code`}),` deve ser alfanumérico, com 1 a 64 caracteres (`,_jsx(_components.code,{children:`^[A-Za-z0-9]{1,64}$`}),`). Um UUID ou qualquer outro valor fora desse padrão retorna `,_jsx(_components.code,{children:`422`}),` e não é encaminhado.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Campo (API)`}),_jsx(_components.th,{children:`Tipo`}),_jsx(_components.th,{children:`Descrição`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`id`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`string`}),` (UUID)`]}),_jsx(_components.td,{children:`Identificador interno do ativo`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`name`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`string`})}),_jsx(_components.td,{children:`Nome do título`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`cetip_code`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`string`})}),_jsxs(_components.td,{children:[`Código do título na CETIP — identificador público (alinha com `,_jsx(_components.code,{children:`asset_code`}),` na ordem)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`asset_type`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`string`})}),_jsxs(_components.td,{children:[`Tipo do título. Valores: enum `,_jsx(_components.strong,{children:`AssetType`}),` (tabela abaixo)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`asset_indexer`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`string`})}),_jsxs(_components.td,{children:[`Indexador do título. Valores: enum `,_jsx(_components.strong,{children:`AssetIndexer`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`maturity_date`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`string`}),` (data)`]}),_jsxs(_components.td,{children:[`Data de vencimento (`,_jsx(_components.code,{children:`YYYY-MM-DD`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`grace_date`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`string`}),` (data)`]}),_jsxs(_components.td,{children:[`Data de carência (`,_jsx(_components.code,{children:`YYYY-MM-DD`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`interest_redemption_type`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`string`})}),_jsxs(_components.td,{children:[`Periodicidade ou forma de resgate dos `,_jsx(_components.strong,{children:`juros`}),`. Valores: enum `,_jsx(_components.strong,{children:`AssetInterestRedemptionType`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`redemption_type`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`string`})}),_jsxs(_components.td,{children:[`Tipo de resgate do `,_jsx(_components.strong,{children:`principal`}),`. Valores: enum `,_jsx(_components.strong,{children:`AssetRedemptionType`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`issuer_name`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`string`})}),_jsx(_components.td,{children:`Nome do emissor`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`issuing_date`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`string`}),` (data)`]}),_jsxs(_components.td,{children:[`Data de emissão (`,_jsx(_components.code,{children:`YYYY-MM-DD`}),`)`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`indexacao-e-rentabilidade`,children:`Indexação e rentabilidade`}),`\n`,_jsxs(_components.p,{children:[`A `,_jsx(_components.strong,{children:`indexação`}),` descreve em que indicador o título se ancora (por exemplo CDI ou IPCA). No livro de ofertas esse dado aparece em `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`asset_indexer`})}),` e segue os valores do enum `,_jsx(_components.strong,{children:`AssetIndexer`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`A `,_jsx(_components.strong,{children:`rentabilidade`}),` da oferta está nos campos do `,_jsx(_components.strong,{children:`Ask`}),` (sempre `,_jsx(_components.strong,{children:`string`}),` no JSON, ou `,_jsx(_components.code,{children:`null`}),`):`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`ask_percentage_yield`})}),` — parcela `,_jsx(_components.strong,{children:`pós-fixada`}),` em relação ao indexador, expressa como fração do indicador (por exemplo `,_jsx(_components.code,{children:`\"1.0\"`}),` para 100% do CDI). Use quando a remuneração é um múltiplo do indexador `,_jsx(_components.strong,{children:`sem`}),` spread prefixado explícito sobre o indicador.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`ask_prefixed_yield`})}),` — parcela `,_jsx(_components.strong,{children:`prefixada`}),` ou `,_jsx(_components.strong,{children:`spread`}),` sobre o indexador, em decimal (por exemplo `,_jsx(_components.code,{children:`\"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.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Em resumo: títulos `,_jsx(_components.strong,{children:`só pós-fixados`}),` em relação ao indicador tendem a preencher `,_jsx(_components.code,{children:`ask_percentage_yield`}),` e deixar `,_jsx(_components.code,{children:`ask_prefixed_yield`}),` como `,_jsx(_components.code,{children:`null`}),`. Estruturas `,_jsx(_components.strong,{children:`indicador + spread`}),` (ou parcela prefixada relevante) tendem a preencher `,_jsx(_components.code,{children:`ask_prefixed_yield`}),` e podem deixar `,_jsx(_components.code,{children:`ask_percentage_yield`}),` como `,_jsx(_components.code,{children:`null`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Por exemplo, um título que rende 100% do CDI e não tem spread sobre o indicador terá `,_jsx(_components.code,{children:`ask_percentage_yield`}),` como `,_jsx(_components.code,{children:`\"1.0\"`}),` e `,_jsx(_components.code,{children:`ask_prefixed_yield`}),` como `,_jsx(_components.code,{children:`null`}),`. Já um título que rende CDI + 2% terá `,_jsx(_components.code,{children:`ask_prefixed_yield`}),` como `,_jsx(_components.code,{children:`\"0.02\"`}),` e `,_jsx(_components.code,{children:`ask_percentage_yield`}),` como `,_jsx(_components.code,{children:`null`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`O endpoint de ativo `,_jsx(_components.strong,{children:`não`}),` devolve campos de rentabilidade. Para convenções de datas e valores numéricos, veja `,_jsx(_components.a,{href:`/api-reference/definicoes`,children:`Definições`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`enums-ativo`,children:`Valores enumerados retornados pela API`}),`\n`,_jsx(_components.p,{children:`Os valores abaixo são os serializados em JSON (como a API devolve nas strings dos campos indicados).`}),`\n`,_jsxs(Heading,{level:`3`,id:`tipo-de-um-ativo-assettype`,children:[`Tipo de um ativo (`,_jsx(_components.code,{children:`AssetType`}),`)`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Valor JSON`}),_jsx(_components.th,{children:`Significado`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`CDB`})}),_jsx(_components.td,{children:`Certificado de depósito bancário`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`LCI`})}),_jsx(_components.td,{children:`Letra de crédito imobiliário`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`LCA`})}),_jsx(_components.td,{children:`Letra de crédito do agronegócio`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`LCD`})}),_jsx(_components.td,{children:`Letra de crédito de desenvolvimento`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`LF`})}),_jsx(_components.td,{children:`Letra financeira`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`CRI`})}),_jsx(_components.td,{children:`Certificado de recebíveis imobiliários`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`CRA`})}),_jsx(_components.td,{children:`Certificado de recebíveis do agronegócio`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`DEB`})}),_jsx(_components.td,{children:`Debênture`})]})]})]}),`\n`,_jsxs(Heading,{level:`3`,id:`indexador-de-um-ativo-assetindexer`,children:[`Indexador de um ativo (`,_jsx(_components.code,{children:`AssetIndexer`}),`)`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Valor JSON`}),_jsx(_components.th,{children:`Significado`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`CDI`})}),_jsx(_components.td,{children:`CDI`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`IPCA`})}),_jsx(_components.td,{children:`IPCA`})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`O indexador aparece em `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`asset_indexer`})}),` nas respostas de ofertas e de ativo. Use esta mesma tabela de valores.`]})}),`\n`,_jsxs(Heading,{level:`3`,id:`tipo-de-resgate-do-principal-assetredemptiontype`,children:[`Tipo de resgate do principal (`,_jsx(_components.code,{children:`AssetRedemptionType`}),`)`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Valor JSON`}),_jsx(_components.th,{children:`Descrição`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`at_maturity`})}),_jsx(_components.td,{children:`Principal pago ou incorporado no vencimento`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`daily`})}),_jsx(_components.td,{children:`Fluxo de principal com periodicidade diária`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`monthly`})}),_jsx(_components.td,{children:`Fluxo de principal com periodicidade mensal`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`yearly`})}),_jsx(_components.td,{children:`Fluxo de principal com periodicidade anual`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`unknown`})}),_jsx(_components.td,{children:`Não informado ou não classificado`})]})]})]}),`\n`,_jsxs(Heading,{level:`3`,id:`tipo-de-resgate-dos-juros-assetinterestredemptiontype`,children:[`Tipo de resgate dos juros (`,_jsx(_components.code,{children:`AssetInterestRedemptionType`}),`)`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Valor JSON`}),_jsx(_components.th,{children:`Descrição`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`at_maturity`})}),_jsx(_components.td,{children:`Juros pagos ou incorporados no vencimento`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`daily`})}),_jsx(_components.td,{children:`Fluxo de juros com periodicidade diária`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`monthly`})}),_jsx(_components.td,{children:`Fluxo de juros com periodicidade mensal`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`yearly`})}),_jsx(_components.td,{children:`Fluxo de juros com periodicidade anual`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`unknown`})}),_jsx(_components.td,{children:`Não informado ou não classificado`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`via-api`,children:`Via API`}),`\n`,_jsxs(_components.p,{children:[`Consulte o título pelo `,_jsx(_components.code,{children:`cetip_code`}),`. Nas ofertas, os mesmos enums aparecem em campos flat do `,_jsx(_components.strong,{children:`Ask`}),`. Nas ordens, use `,_jsx(_components.code,{children:`asset_code`}),`, `,_jsx(_components.code,{children:`asset_type`}),` e `,_jsx(_components.code,{children:`metadata`}),`. O PDF CETIP é baixado pela ordem: `,_jsx(_components.a,{href:`/api-reference/endpoint/baixar-cetip-ordem`,children:`Baixar arquivo CETIP`}),`.`]}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Detalhes de um ativo`,icon:`layer-group`,href:`/api-reference/endpoint/detalhes-ativo`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`GET /assets/{cetip_code}`}),` — detalhes de um ativo pelo código CETIP.`]})}),_jsx(Card,{title:`Listar ofertas`,icon:`book-open`,href:`/api-reference/endpoint/listar-ofertas`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`GET /asks`}),` — lista de ofertas com filtros por tipo, indexador, vencimento e código CETIP.`]})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Ativo","description":"O esquema Asset e os dados do título nas respostas da API — identificação por cetip_code.","href":"/ativo"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Visão geral","slug":"visão-geral","depth":2,"children":[]},{"title":"Campos do esquema Asset","slug":"campos-asset","depth":2,"children":[]},{"title":"Indexação e rentabilidade","slug":"indexacao-e-rentabilidade","depth":2,"children":[]},{"title":"Valores enumerados retornados pela API","slug":"enums-ativo","depth":2,"children":[{"title":"Tipo de um ativo (AssetType)","slug":"tipo-de-um-ativo-assettype","depth":3,"children":[]},{"title":"Indexador de um ativo (AssetIndexer)","slug":"indexador-de-um-ativo-assetindexer","depth":3,"children":[]},{"title":"Tipo de resgate do principal (AssetRedemptionType)","slug":"tipo-de-resgate-do-principal-assetredemptiontype","depth":3,"children":[]},{"title":"Tipo de resgate dos juros (AssetInterestRedemptionType)","slug":"tipo-de-resgate-dos-juros-assetinterestredemptiontype","depth":3,"children":[]}]},{"title":"Via API","slug":"via-api","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"liquiditi","siteName":"Liquiditi","title":"Ativo - Liquiditi","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-30T17:38:45.001Z","originalFileLocation":"ativo.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"O esquema Asset e os dados do título nas respostas da API — identificação por cetip_code.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Liquiditi\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/liquiditi/8whqf87l4Dd3rVkW/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/liquiditi/8whqf87l4Dd3rVkW/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/liquiditi/8whqf87l4Dd3rVkW/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/liquiditi/8whqf87l4Dd3rVkW/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/liquiditi/8whqf87l4Dd3rVkW/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/liquiditi/8whqf87l4Dd3rVkW/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/liquiditi/8whqf87l4Dd3rVkW/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/liquiditi/8whqf87l4Dd3rVkW/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/liquiditi/8whqf87l4Dd3rVkW/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Ativo - Liquiditi\">\u003cmeta data-mint-head property=\"og:description\" content=\"O esquema Asset e os dados do título nas respostas da API — identificação por cetip_code.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Liquiditi\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developer.liquiditi.com.br/ativo\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://liquiditi.mintlify.site/_mintlify/api/og/v2?division=Plataforma\u0026amp;title=Ativo\u0026amp;description=O+esquema+Asset+e+os+dados+do+t%C3%ADtulo+nas+respostas+da+API+%E2%80%94+identifica%C3%A7%C3%A3o+por+cetip_code.\u0026amp;theme=1700c0567daad3124313bba7\u0026amp;signature=7faf2588ca3b331c76b8d94890eb303d20d83f1d1a092e25ee7c077de1464402\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Ativo - Liquiditi\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"O esquema Asset e os dados do título nas respostas da API — identificação por cetip_code.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://liquiditi.mintlify.site/_mintlify/api/og/v2?division=Plataforma\u0026amp;title=Ativo\u0026amp;description=O+esquema+Asset+e+os+dados+do+t%C3%ADtulo+nas+respostas+da+API+%E2%80%94+identifica%C3%A7%C3%A3o+por+cetip_code.\u0026amp;theme=1700c0567daad3124313bba7\u0026amp;signature=7faf2588ca3b331c76b8d94890eb303d20d83f1d1a092e25ee7c077de1464402\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/liquiditi/8whqf87l4Dd3rVkW/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Liquiditi\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developer.liquiditi.com.br/ativo\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ativo.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developer.liquiditi.com.br/#organization\",\"name\":\"Liquiditi\",\"url\":\"https://developer.liquiditi.com.br\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/liquiditi/40kYDMt7UMG66RqF/logo/logo.svg?fit=max\u0026auto=format\u0026n=40kYDMt7UMG66RqF\u0026q=85\u0026s=3e7f35a6d4b189758857f786c6883dea\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developer.liquiditi.com.br#website\",\"name\":\"Liquiditi\",\"url\":\"https://developer.liquiditi.com.br\",\"publisher\":{\"@id\":\"https://developer.liquiditi.com.br/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developer.liquiditi.com.br/ativo#webpage\",\"url\":\"https://developer.liquiditi.com.br/ativo\",\"name\":\"Ativo\",\"description\":\"O esquema Asset e os dados do título nas respostas da API — identificação por cetip_code.\",\"dateModified\":\"2026-09-30T17:38:45.001Z\",\"isPartOf\":{\"@id\":\"https://developer.liquiditi.com.br#website\"},\"breadcrumb\":{\"@id\":\"https://developer.liquiditi.com.br/ativo#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developer.liquiditi.com.br/ativo#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Plataforma\",\"item\":\"https://developer.liquiditi.com.br/renda-fixa\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Ativo\",\"item\":\"https://developer.liquiditi.com.br/ativo\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://developer.liquiditi.com.br/ativo#article\",\"headline\":\"Ativo\",\"name\":\"Ativo\",\"description\":\"O esquema Asset e os dados do título nas respostas da API — identificação por cetip_code.\",\"url\":\"https://developer.liquiditi.com.br/ativo\",\"mainEntityOfPage\":{\"@id\":\"https://developer.liquiditi.com.br/ativo#webpage\"},\"dateModified\":\"2026-09-30T17:38:45.001Z\",\"publisher\":{\"@id\":\"https://developer.liquiditi.com.br/#organization\"},\"isPartOf\":{\"@id\":\"https://developer.liquiditi.com.br#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Liquiditi\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Liquiditi\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/ativo.md","siteName":"Liquiditi","nav":{"global":{"anchors":[{"anchor":"Acessar plataforma","icon":"up-right-from-square","href":"https://app.liquiditi.com.br"}]},"tabs":[{"tab":"Documentação","groups":[{"group":"Começando","pages":[{"title":"Introdução","href":""},{"title":"Solicitar acesso","href":"/acesso-a-plataforma"}]},{"group":"Plataforma","pages":[{"title":"Renda Fixa","description":"Explore os ativos disponíveis e encontre oportunidades de negociação na Liquiditi.","href":"/renda-fixa"},{"title":"Ativo","href":"/ativo"},{"title":"Ordens","description":"Acompanhe o histórico e os detalhes de cada ordem realizada na plataforma Liquiditi.","href":"/ordens"}]}]},{"tab":"Referência da API","pages":[{"title":"Referência da API","href":"/api-reference/introduction"}]}]},"basePath":"","title":"Ativo - Liquiditi","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":[],"chunks":[]}