From 75c352d27ff33c1be6f726093949f9cc33962907 Mon Sep 17 00:00:00 2001
From: "[Luis Rodrigues]" <sanctus.hck@gmail.com>
Date: Mon, 17 Jun 2024 15:55:25 +0100
Subject: [PATCH] adicionada chamada 'nfts_collection_data_by_id()'

---
 modulos/coingecko_api.py | 25 +++++++++++++++++++++----
 1 file changed, 21 insertions(+), 4 deletions(-)

diff --git a/modulos/coingecko_api.py b/modulos/coingecko_api.py
index ec2deee..dbbd528 100644
--- a/modulos/coingecko_api.py
+++ b/modulos/coingecko_api.py
@@ -1482,16 +1482,33 @@ def nfts_list(
 # else:
 #     print(f'erro {codigo}: {dados}')
 
-def nfts_collection_data_by_id() -> tuple[str, int, dict]:
-    pass
+def nfts_collection_data_by_id(id_nft: str = '') -> tuple[str, int, dict]:
+    '''https://docs.coingecko.com/v3.0.1/reference/nfts-id
+    
+    este endpoint permite obter todos os dados do NTF (nome, preco minimo, 
+    volume 24hrs, etc) a partir do id da coleccao NFT
+    '''
+    # dicionario de parametros
+    api_parameters: dict = {
+        'id': ''
+    }
+    # validacao de parametros
+    # id_nft ( como 'id' é um nome reservado, foi usado outro nome)
+    if not isinstance(id_nft, str):
+        raise TypeError('\'id_nft\' tem de ser do tipo \'str\'')
+    if id_nft == '':
+        raise ValueError('\'id_nft\' tem de ser definido')
+    api_parameters['id'] = id_nft
+
+    return API(f'nfts/{api_parameters['id']}', api_parameters)
 
 
 # debug (decomentar linhas seguintes para testar funcao)
-# url, codigo, dados = <nome_chamada_api()>
+# url, codigo, dados = nfts_collection_data_by_id('pudgy-penguins')
 # print(f'url: {url}')
 # if codigo == 200:        
 #     for item in dados:
-#         print(item)
+#         print(f'{item}: {dados[item]}')
 # else:
 #     print(f'erro {codigo}: {dados}')