Polígono (Editor Independente) (versão prévia)
A API de Ações Polygon.io fornece pontos de extremidade REST que permitem consultar os dados mais recentes do mercado de todas as bolsas de valores dos EUA.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Itransition Group Ltd |
| URL | https://www.itransition.com/ |
| v.sumar@itransition.com |
| Metadados do conector | |
|---|---|
| Publicador | Itransition Group Ltd |
| Site | https://polygon.io/ |
| Política de privacidade | https://polygon.io/privacy |
| Categorias | Dados; Financiar |
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| apiKey | secureString | A apiKey para esta api | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Detalhes do ticker |
Obtenha um único detalhe do ticker. |
| Dividendos |
Obtenha uma lista de dividendos históricos em dinheiro. |
| Divisões de ações |
Obtenha uma lista de divisões de ações históricas. |
| Eventos do ticker |
Obtenha uma linha do tempo de eventos para a entidade associada ao ticker especificado. |
| Fechamento Aberto Diariamente |
Obtenha os preços abertos, próximos e posteriores de um símbolo de ação em uma determinada data. |
| Finanças de Ações |
Retorna dados financeiros para um determinado ticker ou empresa com base em vários filtros. |
| Intercâmbios |
Obtenha uma lista de trocas, incluindo ações, opções, criptografia e muito mais. |
| Tickers |
Consultar todos os símbolos de ticker. |
Detalhes do ticker
Obtenha um único detalhe do ticker.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Ticker
|
ticker | True | string |
O símbolo do ticker do ativo. |
|
Date
|
date | date |
Especifique uma data para obter informações sobre o ticker. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
count
|
count | integer |
O número total de resultados dessa solicitação. |
|
request_id
|
request_id | string |
Uma ID de solicitação atribuída pelo servidor. |
|
ativo
|
results.active | boolean |
Se o ticker está ativo. |
|
endereço1
|
results.address.address1 | string |
O endereço da empresa. |
|
city
|
results.address.city | string | |
|
postal_code
|
results.address.postal_code | string | |
|
estado
|
results.address.state | string | |
|
icon_url
|
results.branding.icon_url | string | |
|
logo_url
|
results.branding.logo_url | string | |
|
cik
|
results.cik | string |
CIK da empresa (Chave de Índice Central). |
|
composite_figi
|
results.composite_figi | string | |
|
currency_name
|
results.currency_name | string | |
|
descrição
|
results.description | string | |
|
market_cap
|
results.market_cap | number |
Capitalização de mercado da empresa. |
|
mercado
|
results.market | string | |
|
nome
|
results.name | string | |
|
primary_exchange
|
results.primary_exchange | string | |
|
Ticker
|
results.ticker | string | |
|
sic_code
|
results.sic_code | string | |
|
sic_description
|
results.sic_description | string | |
|
total_employees
|
results.total_employees | integer | |
|
tipo
|
results.type | string | |
|
weighted_shares_outstanding
|
results.weighted_shares_outstanding | number |
O número de ações ponderadas em circulação. |
Dividendos
Obtenha uma lista de dividendos históricos em dinheiro.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Ticker
|
ticker | True | string |
Especifique um símbolo de ticker que diferencia maiúsculas de minúsculas. |
|
Data do ex-dividendo
|
ex_dividend_date | string |
Consulta por data de ex-dividendo com o formato YYYY-MM-DD. |
|
|
Data de registro
|
record_date | string |
Consultar por data de registro com o formato YYYY-MM-DD. |
|
|
Data da declaração
|
declaration_date | string |
Consulta por data de declaração com o formato YYYY-MM-DD. |
|
|
Data de pagamento
|
pay_date | string |
Consultar por data de pagamento com o formato YYYY-MM-DD. |
|
|
Frequência
|
frequency | integer |
Consulte pelo número de vezes por ano que o dividendo é pago. |
|
|
Valor em dinheiro
|
cash_amount | number |
Consultar pelo valor em dinheiro do dividendo. |
|
|
Tipo de Dividendo
|
dividend_type | string |
Consultar pelo tipo de dividendo. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
next_url
|
next_url | string |
URL para a próxima página de resultados |
|
results
|
results | array of object |
Lista de dividendos históricos |
|
cash_amount
|
results.cash_amount | float |
O valor em dinheiro do dividendo |
|
declaration_date
|
results.declaration_date | string |
A data em que o dividendo foi declarado |
|
ex_dividend_date
|
results.ex_dividend_date | string |
A data em que as ações começam a ser negociadas sem o valor do dividendo |
|
frequência
|
results.frequency | integer |
A frequência dos pagamentos de dividendos |
|
id
|
results.id | string |
Identificador exclusivo para o registro de dividendos |
|
pay_date
|
results.pay_date | string |
A data em que o dividendo é pago aos acionistas |
|
record_date
|
results.record_date | string |
A data em que o acionista deve possuir a ação para receber o dividendo |
|
Ticker
|
results.ticker | string |
Símbolo do ticker do estoque |
|
status
|
status | string |
Status da resposta à API. |
Divisões de ações
Obtenha uma lista de divisões de ações históricas.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Ticker
|
ticker | True | string |
O símbolo do ticker do ativo. |
|
Data de execução
|
execution_date | string |
Consulta por data de execução com o formato YYYY-MM-DD. |
|
|
Divisão inversa
|
reverse_split | boolean |
Consultar divisões de ações inversas. |
|
|
Pedido
|
order | string |
Ordenar resultados com base no campo de classificação. |
|
|
Limit
|
limit | integer |
Limitar o número de resultados retornados |
|
|
Classificar
|
sort | string |
Campo de classificação usado para ordenação. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
next_url
|
next_url | string |
URL para a próxima página de resultados |
|
results
|
results | array of object |
Lista de divisões de ações históricas |
|
execution_date
|
results.execution_date | string |
Data da execução da divisão de ações |
|
id
|
results.id | string |
Identificador exclusivo para o registro de divisão de ações |
|
split_from
|
results.split_from | integer |
Taxa de divisão de |
|
split_to
|
results.split_to | integer |
Taxa de divisão para |
|
Ticker
|
results.ticker | string |
Símbolo do ticker do ativo |
|
status
|
status | string |
Status da resposta à API. |
Eventos do ticker
Obtenha uma linha do tempo de eventos para a entidade associada ao ticker especificado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID
|
id | True | string |
Identificador de um ativo (Ticker, CUSIP ou FIGI composto) |
|
Tipos
|
types | string |
Uma lista separada por vírgulas dos tipos de eventos a serem incluídos. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
status
|
status | string |
O status da solicitação |
|
request_id
|
request_id | string |
Uma ID de solicitação exclusiva atribuída pelo servidor |
|
events
|
results.events | array of object | |
|
date
|
results.events.date | string |
Data do evento |
|
Ticker
|
results.events.ticker_change.ticker | string |
O novo ticker após a alteração |
Fechamento Aberto Diariamente
Obtenha os preços abertos, próximos e posteriores de um símbolo de ação em uma determinada data.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Ticker
|
stocksTicker | True | string |
Especifique um símbolo de ticker que diferencia maiúsculas de minúsculas. |
|
Date
|
date | True | string |
A data da abertura/fechamento solicitada no formato YYYY-MM-DD. |
|
Ajustado
|
adjusted | boolean |
Se os resultados são ajustados ou não para divisões. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
status
|
status | string |
status |
|
from
|
from | string |
from |
|
símbolo
|
symbol | string |
símbolo |
|
em aberto
|
open | float |
em aberto |
|
high
|
high | float |
high |
|
low
|
low | float |
low |
|
fechar
|
close | float |
fechar |
|
volume
|
volume | float |
volume |
|
Afterhours
|
afterHours | float |
Afterhours |
|
preMarket
|
preMarket | float |
preMarket |
Finanças de Ações
Retorna dados financeiros para um determinado ticker ou empresa com base em vários filtros.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Ticker
|
ticker | string |
O símbolo do ticker para filtrar dados financeiros. |
|
|
Cic
|
cik | string |
O número da chave de índice central (CIK) para filtrar dados financeiros. |
|
|
Nome da empresa
|
company_name | string |
O nome da empresa para filtrar dados financeiros. |
|
|
Sic
|
sic | string |
Classificação industrial padrão para filtrar dados financeiros. |
|
|
Data de arquivamento
|
filing_date | string |
Filtre dados financeiros até a data de arquivamento (YYYY-MM-DD). |
|
|
Período de data do relatório
|
period_of_report_date | string |
O período de relatório para o arquivamento com dados financeiros (YYYY-MM-DD). |
|
|
Período de tempo
|
timeframe | string |
Filtrar por período de tempo (por exemplo, anual ou trimestral). |
|
|
Fontes indlúdios
|
include_sources | boolean |
Se deve incluir |
|
|
Pedido
|
order | string |
Ordenar resultados com base no campo de classificação. |
|
|
Limit
|
limit | integer |
Limite o número de resultados. O padrão é 10, o máximo é 100. |
|
|
Classificar
|
sort | string |
Classificar campo para ordenação. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
count
|
count | integer |
O número total de resultados. |
|
next_url
|
next_url | string |
URL para a próxima página de resultados. |
|
request_id
|
request_id | string |
Uma ID de solicitação atribuída pelo servidor. |
|
results
|
results | array of object | |
|
cik
|
results.cik | string |
Chave de Índice Central (CIK). |
|
company_name
|
results.company_name | string |
Nome da empresa. |
|
end_date
|
results.end_date | string |
Data de término do relatório financeiro. |
|
filing_date
|
results.filing_date | string |
Data em que o arquivamento foi enviado. |
|
fiscal_period
|
results.fiscal_period | string |
Período fiscal (por exemplo, 1º trimestre). |
|
fiscal_year
|
results.fiscal_year | string |
Exercício. |
|
start_date
|
results.start_date | string |
Data de início do relatório financeiro. |
|
source_filing_file_url
|
results.source_filing_file_url | string |
URL do arquivo de arquivamento de origem. |
|
etiqueta
|
results.financials.balance_sheet.assets.label | string | |
|
unidade
|
results.financials.balance_sheet.assets.unit | string | |
|
value
|
results.financials.balance_sheet.assets.value | float | |
|
etiqueta
|
results.financials.balance_sheet.liabilities.label | string | |
|
unidade
|
results.financials.balance_sheet.liabilities.unit | string | |
|
value
|
results.financials.balance_sheet.liabilities.value | float | |
|
etiqueta
|
results.financials.balance_sheet.equity.label | string | |
|
unidade
|
results.financials.balance_sheet.equity.unit | string | |
|
value
|
results.financials.balance_sheet.equity.value | double | |
|
etiqueta
|
results.financials.income_statement.revenue.label | string | |
|
unidade
|
results.financials.income_statement.revenue.unit | string | |
|
value
|
results.financials.income_statement.revenue.value | float | |
|
etiqueta
|
results.financials.income_statement.net_income.label | string | |
|
unidade
|
results.financials.income_statement.net_income.unit | string | |
|
value
|
results.financials.income_statement.net_income.value | float | |
|
etiqueta
|
results.financials.cash_flow_statement.net_cash_flow.label | string | |
|
unidade
|
results.financials.cash_flow_statement.net_cash_flow.unit | string | |
|
value
|
results.financials.cash_flow_statement.net_cash_flow.value | float |
Intercâmbios
Obtenha uma lista de trocas, incluindo ações, opções, criptografia e muito mais.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Classe asset
|
asset_class | string |
Filtrar por classe de ativo, por exemplo, ações, opções, criptografia, fx |
|
|
Local
|
locale | string |
Filtrar por localidade |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
count
|
count | integer |
O número total de resultados dessa solicitação. |
|
request_id
|
request_id | string |
Uma ID de solicitação atribuída pelo servidor. |
|
results
|
results | array of object |
Lista de dados do Exchange |
|
acrónimos
|
results.acronym | string |
O acrônimo da troca |
|
asset_class
|
results.asset_class | string |
A classe de ativo à qual a bolsa dá suporte (por exemplo, ações) |
|
id
|
results.id | integer |
A ID da troca |
|
localidade
|
results.locale | string |
A localidade (país/região) da troca |
|
Microfone
|
results.mic | string |
O MIC (código do identificador de mercado) da troca |
|
nome
|
results.name | string |
O nome completo da troca |
|
operating_mic
|
results.operating_mic | string |
O MIC operacional da troca |
|
participant_id
|
results.participant_id | string |
A ID do participante da troca |
|
tipo
|
results.type | string |
O tipo da troca |
|
url
|
results.url | string |
A URL do site do exchange |
|
status
|
status | string |
O status da solicitação |
Tickers
Consultar todos os símbolos de ticker.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Ticker
|
ticker | string |
Especifique um símbolo de ticker. O padrão é a cadeia de caracteres vazia que consulta todos os tickers. |
|
|
Tipo
|
type | string |
Especifique o tipo de tickers (por exemplo, estoque, criptografia). |
|
|
Mercado
|
market | string |
Filtrar por tipo de mercado. O padrão é para todos os mercados. |
|
|
Troca
|
exchange | string |
Especifique a troca primária do ativo no formato de código ISO. |
|
|
CUSIP
|
cusip | string |
Especifique o código CUSIP do ativo que você deseja pesquisar. |
|
|
CIK
|
cik | string |
Especifique o código CIK do ativo que você deseja pesquisar. |
|
|
Date
|
date | string |
Especifique uma data para recuperar tickers (formato YYYY-MM-DD). |
|
|
Pesquisa
|
search | string |
Pesquise termos dentro do ticker e/ou nome da empresa. |
|
|
Active
|
active | boolean |
Especifique se os tiques retornados devem ser negociados ativamente na data consultada. |
|
|
Pedido
|
order | string |
Ordenar resultados com base no campo de classificação. |
|
|
Classificar
|
sort | string |
Campo de classificação usado para ordenação. |
|
|
Limit
|
limit | integer |
Limite o número de tiques retornados no resultado.. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
status
|
status | string |
Status da resposta |
|
count
|
count | integer |
Número de resultados |
|
results
|
results | array of object | |
|
ativo
|
results.active | boolean |
Se o ticker está ativo |
|
cik
|
results.cik | string |
O CIK (Chave de Índice Central) do ativo |
|
composite_figi
|
results.composite_figi | string |
A FIGI composta do ativo |
|
currency_name
|
results.currency_name | string |
A moeda do ativo |
|
mercado
|
results.market | string |
O tipo de mercado (por exemplo, ações, criptografia) |
|
nome
|
results.name | string |
O nome do ativo |
|
primary_exchange
|
results.primary_exchange | string |
A principal troca do ativo |
|
Ticker
|
results.ticker | string |
O símbolo do ticker |
|
tipo
|
results.type | string |
O tipo do ativo |