adicionada chamada 'search_queries()'

modulos/coingecko_api.py

@@ -1573,16 +1573,31 @@ def btc_to_currency_exchange_rates() -> tuple[str, int, dict]:
 # else:
 #     print(f'erro {codigo}: {dados}')
 
-def search_queries() -> tuple[str, int, dict]:
-    pass
+def search_queries(query: str = '') -> tuple[str, int, dict]:
+    '''https://docs.coingecko.com/v3.0.1/reference/search-data
+    
+    este endpoint permite realizar um pesquisa por moedas, categorias e mercados listados em CoinGecko
+    '''
+    # dicionario parametros
+    api_parameters: dict = {
+        'query': '',
+    }
+    # validacao de parametros
+    if not isinstance(query, str):
+        raise TypeError('\'query\' tem de ser do tipo \'str\'')
+    if query == '':
+        raise ValueError('\'query\' tem de ser definido')
+    api_parameters['query'] = query
+    
+    return API(f'search', api_parameters)
 
 
 # debug (decomentar linhas seguintes para testar funcao)
-# url, codigo, dados = <nome_chamada_api()>
+# url, codigo, dados = search_queries('dogecoin')
 # print(f'url: {url}')
 # if codigo == 200:        
 #     for item in dados:
-#         print(item)
+#         print(f'{item}: {dados[item]}')
 # else:
 #     print(f'erro {codigo}: {dados}')