Combina conjuntos definidos por duas relações
Aplica `intersect`, `union` ou `difference` a conjuntos definidos por duas relações. `a_to_id` e `b_to_id` prendem a contraparte e permitem comparar dois objetos concretos. Use `total=true` e leia `meta.total` para obter o tamanho sem paginar.
In: header
Query Parameters
Cursor opaco de meta.next_cursor da página anterior; omita na primeira página.
Itens por página (1–1000, default 100).
1001 <= value <= 1000true = inclui meta.total (contagem do universo filtrado). Custa uma consulta a mais.
Primeira relação.
"issued" | "distributes" | "tokenized_as" | "registered_as" | "assigned_to" | "owes_under" | "holds" | "manages" | "administers" | "custodies" | "audits" | "same_owner" | "shareholder_of" | "indexed_to" | "rates" | "mentions" | "measures" | "forecasts" | "contains" | "member_of" | "exposed_to_issuer" | "succeeded_by" | "produces" | "covers" | "coordinates" | "offers" | "exposed_to_sector" | "regulated_by" | "amends" | "revokes"Segunda relação.
"issued" | "distributes" | "tokenized_as" | "registered_as" | "assigned_to" | "owes_under" | "holds" | "manages" | "administers" | "custodies" | "audits" | "same_owner" | "shareholder_of" | "indexed_to" | "rates" | "mentions" | "measures" | "forecasts" | "contains" | "member_of" | "exposed_to_issuer" | "succeeded_by" | "produces" | "covers" | "coordinates" | "offers" | "exposed_to_sector" | "regulated_by" | "amends" | "revokes"Direção da relação a a partir do objeto da coorte (default out).
"out""out" | "in"Direção da relação b a partir do objeto da coorte (default out).
"out""out" | "in"Prende a outra ponta da relação A.
Prende a outra ponta da relação B.
Tipo da outra ponta de A. issued alcança instrument e equity_security; recorte para separar dívida de ação.
"company" | "equity_security" | "fund" | "service_provider" | "instrument" | "index" | "crypto_asset" | "commodity" | "country" | "indicator" | "data_series" | "offering" | "fund_share_class" | "market_event" | "role" | "sector" | "securitization" | "norm"Tipo da outra ponta de B.
"company" | "equity_security" | "fund" | "service_provider" | "instrument" | "index" | "crypto_asset" | "commodity" | "country" | "indicator" | "data_series" | "offering" | "fund_share_class" | "market_event" | "role" | "sector" | "securitization" | "norm"Tipo canônico do objeto. equity_security é o papel, separado de company; securitization é a emissão, separada da série negociável (instrument); e fund_share_class é a subclasse, separada da classe com CNPJ (fund). indicator representa o conceito medido, enquanto data_series representa uma publicação ou cálculo específico. offering, market_event e norm são objetos porque possuem identidade, atributos e relações próprias.
"company" | "equity_security" | "fund" | "service_provider" | "instrument" | "index" | "crypto_asset" | "commodity" | "country" | "indicator" | "data_series" | "offering" | "fund_share_class" | "market_event" | "role" | "sector" | "securitization" | "norm"Recorta dentro do tipo: fidc, fii, debenture.
Corte temporal (AAAA-MM-DD). Sem at, usa o acervo histórico. Conforme o shape de listObjectRelations, event acumula até a data, snapshot escolhe o retrato aplicável e static pode ser recusada por não afirmar vigência passada.
^\d{4}-\d{2}-\d{2}$name é alfabética. a_count, b_count e total ordenam pelo número de contrapartes distintas; em union e difference só a_count se aplica.
"name""name" | "a_count" | "b_count" | "total"intersect = nos dois; union = em qualquer um; difference = em A e não em B.
"intersect""intersect" | "union" | "difference"Response Body
curl -X GET "https://api.databolsa.com/v1/objects/intersect?cursor=string&limit=100&total=string&a=issued&b=issued&a_direction=out&b_direction=out&a_to_id=string&b_to_id=string&a_to_kind=company&b_to_kind=company&kind=company&subkind=string&at=string&order=name&op=intersect"{
"data": [
{
"id": "string",
"kind": "string",
"subkind": "string",
"name": "string",
"cnpj": "string",
"tickers": [
"string"
],
"a_count": 0,
"b_count": 0
}
],
"meta": {
"next_cursor": "string",
"count": 0,
"total": 0,
"subject": {
"property1": "string",
"property2": "string"
},
"as_of": "string",
"as_of_by_rel": {
"property1": "string",
"property2": "string"
},
"excluded_shapes": [
"event"
],
"order": "name"
}
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"details": {
"property1": null,
"property2": null
}
}Converte uma consulta de objetos em tabela
Executa `getObjectHistory`, `getObjectFacts`, `rankObjects` ou `aggregateObjects` e retorna `{ schema.columns, rows, meta }`. As colunas declaram tipo, papel e unidade; os valores não são recalculados. Passe os parâmetros da operação em `input`; `meta.query` devolve a consulta reexecutável. Lotes com unidades diferentes informam a unidade por linha e deixam a unidade da coluna nula.
Lista as medidas e suas unidades
Lista os `fact` aceitos por `getObjectFacts` e `getObjectHistory`, com objetos aplicáveis e sua régua. Interprete o valor com `unit`, `dimension`, `scale` e `period`: `ratio` é fração, `pct` é percentual e escalas como `thousand` não são aplicadas ao valor servido. Em `unit=native`, a unidade varia por série; consulte o objeto da série para obter a unidade resolvida.