adicionada chamada 'public_companies_holdings()'

modulos/coingecko_api.py

@@ -1667,15 +1667,30 @@ def global_defi_market_data() -> tuple[str, int, dict]:
 # else:
 #     print(f'erro {codigo}: {dados}')
 
-def public_companies_holdings() -> tuple[str, int, dict]:
-    pass
+def public_companies_holdings(coin_id: str = '') -> tuple[str, int, dict]:
+    '''https://docs.coingecko.com/v3.0.1/reference/companies-public-treasury
+    
+    este endpoint permite consultar a participação/posse de BTC ou ETH de empresas
+    '''
+    # dicionario de parametros
+    api_parameters: dict = {
+        'coin_id': '',
+    }
+    # validacao de parametros
+    if not isinstance(coin_id, str):
+        raise TypeError('\'coin_id\' tem de ser do tipo \'str\'')
+    if coin_id == '':
+        raise ValueError('\'coin_id\' tem de ser definido')
+    api_parameters['coin_id'] = coin_id
+
+    return API(f'companies/public_treasury/{api_parameters['coin_id']}', api_parameters)
 
 
 # debug (decomentar linhas seguintes para testar funcao)
-# url, codigo, dados = <nome_chamada_api()>
-# print(f'url: {url}')
-# if codigo == 200:        
-#     for item in dados:
-#         print(item)
-# else:
-#     print(f'erro {codigo}: {dados}')
+url, codigo, dados = public_companies_holdings('bitcoin')
+print(f'url: {url}')
+if codigo == 200:        
+    for item in dados:
+        print(f'{item}: {dados[item]}')
+else:
+    print(f'erro {codigo}: {dados}')