update

TODO.md

@@ -75,4 +75,5 @@
 2. Create secret store and integrate
 3. Create ChatXBT host scalabe hosting (fly or Digital Ocean or RunPod)
 4. Set alerts for billing and uptime
-5. Set error alerts and llm investigation
+5. Set error alerts and llm investigation
+6. Add guard rails - https://github.com/NVIDIA/NeMo-Guardrails

chatxbt-assistant.py

@@ -5,23 +5,20 @@ load_dotenv()
 
 import chainlit as cl
 from phi.assistant import Assistant
-from phi.tools.duckduckgo import DuckDuckGo
 from phi.llm.openai import OpenAIChat
+from phi.tools.duckduckgo import DuckDuckGo
 from phi.tools.yfinance import YFinanceTools
+from src.databases.postgres import sqlalchemy_engine
 from src.tools.coin_data_toolkit import CryptoDataTools
+from phi.storage.assistant.postgres import PgAssistantStorage
+from src.knowledge_bases.knowledge_base import knowledge_base
 
-
-# assistant = Assistant(tools=[DuckDuckGo()], show_tool_calls=True)
-# assistant.print_response("Whats happening in France?", markdown=True)
-
-# f_assistant = Assistant(
-#     llm=OpenAIChat(model="gpt-4o"),
-#     tools=[YFinanceTools(stock_price=True, analyst_recommendations=True, company_info=True, company_news=True)],
-#     show_tool_calls=True,
-#     markdown=True,
-# )
-# f_assistant.print_response("What is the stock price of NVDA")
-# f_assistant.print_response("Write a comparison between NVDA and AMD, use all tools available.")
+storage = PgAssistantStorage(
+    # store runs in the ai.assistant_runs table
+    table_name="assistant_runs",
+    db_engine=sqlalchemy_engine
+)
+knowledge_base.load(recreate=False)
 
 
 @cl.oauth_callback
@@ -72,7 +69,14 @@ def start():
         tools=[CryptoDataTools(), DuckDuckGo(), YFinanceTools(stock_price=True)],
         show_tool_calls= is_dev_mode,
         markdown=True,
+        # knowledge_base=knowledge_base,
+        storage=storage,
+        search_knowledge=True,
+        read_chat_history=True,
+        add_references_to_prompt=True,
+        add_chat_history_to_prompt=True
     )
+    # cxbt_assistant.knowledge_base.load(recreate=False)
 
     # Set the assistant in the user session
     cl.user_session.set("agent", cxbt_assistant)

requirements.txt

@@ -2,6 +2,7 @@ aiofiles==23.2.1
 aiohttp==3.9.5
 aiosignal==1.3.1
 annotated-types==0.7.0
+anthropic==0.28.0
 anyio==3.7.1
 appnope==0.1.4
 asgiref==3.8.1
@@ -30,11 +31,14 @@ exceptiongroup==1.2.1
 executing==2.0.1
 fastapi==0.110.3
 fastjsonschema==2.19.1
+filelock==3.15.1
 filetype==1.2.0
 frozendict==2.4.4
 frozenlist==1.4.1
+fsspec==2024.6.0
 gitdb==4.0.11
 GitPython==3.1.43
+google_search_results==2.4.2
 googleapis-common-protos==1.63.1
 greenlet==3.0.3
 grpcio==1.64.1
@@ -42,11 +46,13 @@ h11==0.14.0
 html5lib==1.1
 httpcore==1.0.5
 httpx==0.27.0
+huggingface-hub==0.23.3
 idna==3.7
 importlib_metadata==7.1.0
 ipython==8.12.3
 jedi==0.19.1
 Jinja2==3.1.4
+jiter==0.4.2
 jsonpatch==1.33
 jsonpointer==3.0.0
 jsonschema==4.22.0
@@ -55,9 +61,13 @@ jupyter_client==8.6.2
 jupyter_core==5.7.2
 jupyterlab_pygments==0.3.0
 langchain==0.2.4
+langchain-anthropic==0.1.15
 langchain-community==0.2.4
 langchain-core==0.2.6
+langchain-openai==0.1.8
 langchain-text-splitters==0.2.1
+langchainhub==0.1.20
+langgraph==0.0.68
 langsmith==0.1.77
 Lazify==0.4.0
 literalai==0.0.604
@@ -76,6 +86,7 @@ nbclient==0.10.0
 nbconvert==7.16.4
 nbformat==5.10.4
 nest-asyncio==1.6.0
+numexpr==2.10.0
 numpy==1.26.4
 openai==1.34.0
 opentelemetry-api==1.25.0
@@ -101,6 +112,7 @@ pandocfilters==1.5.1
 parso==0.8.4
 peewee==3.17.5
 pexpect==4.9.0
+pgvector==0.2.5
 phidata==2.4.20
 pickleshare==0.7.5
 pipdeptree==2.22.0
@@ -109,6 +121,8 @@ platformdirs==4.2.2
 prompt_toolkit==3.0.47
 protobuf==4.25.3
 psutil==5.9.8
+psycopg==3.1.19
+psycopg2==2.9.9
 ptyprocess==0.7.0
 pure-eval==0.2.2
 pydantic==2.7.4
@@ -116,6 +130,7 @@ pydantic-settings==2.3.3
 pydantic_core==2.18.4
 Pygments==2.18.0
 PyJWT==2.8.0
+pypeln==0.4.9
 pyreqwest_impersonate==0.4.7
 python-dateutil==2.9.0.post0
 python-dotenv==1.0.1
@@ -128,6 +143,7 @@ PyYAML==6.0.1
 pyzmq==26.0.3
 redis==5.0.6
 referencing==0.35.1
+regex==2024.5.15
 requests==2.32.3
 rich==13.7.1
 rpds-py==0.18.1
@@ -141,14 +157,18 @@ soupsieve==2.5
 SQLAlchemy==2.0.30
 stack-data==0.6.3
 starlette==0.37.2
+stopit==1.1.2
 syncer==2.0.3
 tenacity==8.3.0
+tiktoken==0.7.0
 tinycss2==1.3.0
+tokenizers==0.19.1
 tomli==2.0.1
 tornado==6.4.1
 tqdm==4.66.4
 traitlets==5.14.3
 typer==0.12.3
+types-requests==2.32.0.20240602
 typing-inspect==0.9.0
 typing_extensions==4.12.2
 tzdata==2024.1

run.py

@@ -5,9 +5,7 @@ from src.libs.logger import logger
 # from src.data_sources.coingecko import CoinGecko
 # from src.data_sources.cryptocompare import CryptoCompare
 
-
 # cgc = CoinGecko()
-# ccp = CryptoCompare()
 
 # result = cgc.get_coin_price(ids=["bitcoin", "ethereum"], vs_currencies=["usd"])
 # logger.info(f"Got token price: {result}")
@@ -34,9 +32,20 @@ from src.libs.logger import logger
 # # logger.info(f"Got token data: {result1}")
 # pprint.pprint(result1)
 
-from ai_functions import AIFunctions
+# from src.data_sources.cryptocompare import CryptoCompare
+# ccp = CryptoCompare()
+
+# result = ccp.get_overall_coin_data(symbol="bnb")
+# pprint.pprint(result)
+
+from src.data_sources.cryptocompare import CryptoCompare
+from src.data_sources.dexscreener import DexScreener
+
+crypto_compare = CryptoCompare()
+dex_screener = DexScreener()
 
-aif = AIFunctions()
+dexscreener_coin_data = dex_screener.search(query='PANDORA')
+cryptocompare_coin_data = crypto_compare.get_overall_coin_data(symbol='PANDORA')
 
-result2 = aif.get_asset_price(asset_id="btc", vs_currency="usd")
-pprint.pprint(result2)
+pprint.pprint(dexscreener_coin_data)
+pprint.pprint(cryptocompare_coin_data)

src/data_sources/cryptocompare.py

@@ -1,27 +1,30 @@
 import os
 from dotenv import load_dotenv
+load_dotenv()
 
 import httpx
-from src.libs.helper_functions import convert_to_snakecase
-from src.databases.redis import REDIS_CACHED
-from src.libs.constants import ONE_MINUTE_IN_SECONDS
-from src.libs.constants import CRYPTO_COMPARE_BASE_URL
 from src.libs.logger import logger
-
-
-load_dotenv()
+from src.databases.redis import REDIS_CACHED
+from src.libs.helper_functions import convert_to_snakecase
+from src.libs.constants import (
+    ONE_MINUTE_IN_SECONDS,
+    ONE_QUARTER_IN_SECONDS,
+    CRYPTO_COMPARE_API_BASE_URL,
+    CRYPTO_COMPARE_ASSET_DATA_API_BASE_URL,
+)
 
 redis_cache = REDIS_CACHED
 
 
 class CryptoCompare:
-    def __init__(self, base_url: str = None) -> None:
-        self.CRYPTO_COMPARE_BASE_URL = base_url or CRYPTO_COMPARE_BASE_URL
+    def __init__(self, base_url: str = None, asset_data_base_url: str = None) -> None:
+        self.CRYPTO_COMPARE_API_BASE_URL = base_url or CRYPTO_COMPARE_API_BASE_URL
+        self.CRYPTO_COMPARE_ASSET_DATA_API_BASE_URL = asset_data_base_url or CRYPTO_COMPARE_ASSET_DATA_API_BASE_URL
 
     @redis_cache(ttl=ONE_MINUTE_IN_SECONDS)
     @logger.instrument()
     def get_all_coins(self) -> dict:
-        url = f"{self.CRYPTO_COMPARE_BASE_URL}data/all/coinlist"
+        url = f"{self.CRYPTO_COMPARE_API_BASE_URL}data/all/coinlist"
         logger.debug(url)
         params = {"api_key": os.getenv("CRYPTOCOMPARE_API_KEY")}
         logger.debug(params)
@@ -41,7 +44,7 @@ class CryptoCompare:
     @logger.instrument()
     def get_coin_price(self, ids: list[str], vs_currencies: list[str], cache_ttl: int = None) -> dict:
         
-        url = f"{self.CRYPTO_COMPARE_BASE_URL}data/pricemulti"
+        url = f"{self.CRYPTO_COMPARE_API_BASE_URL}data/pricemulti"
         # logger.debug(url)
 
         params = {
@@ -62,4 +65,30 @@ class CryptoCompare:
         except httpx.HTTPError as e:
             # logger.debug(f"An error occurred while making the request: {e}")
             print(f"An error occurred while making the request: {e}")
+            return None
+        
+    @redis_cache(ttl=ONE_QUARTER_IN_SECONDS)
+    @logger.instrument()
+    def get_overall_coin_data(self, symbol: str, cache_ttl: int = None) -> dict:
+        
+        url = f"{self.CRYPTO_COMPARE_ASSET_DATA_API_BASE_URL}data/by/symbol"
+        logger.debug(f"Query URL: {url}")
+
+        params = {
+            "api_key": os.getenv("CRYPTOCOMPARE_API_KEY"),
+            "asset_symbol": symbol,
+        }
+        logger.debug(f"Query params: {params}")
+
+        headers = {"Content-type":"application/json; charset=UTF-8"}
+        logger.debug(f"Query headers {headers}")
+
+        try:
+            with httpx.Client(timeout=30.0) as client:
+                response = client.get(url, params=params, headers=headers)
+                response.raise_for_status()  # Raise an exception if the request was unsuccessful
+                return response.json()
+        except httpx.HTTPError as e:
+            logger.debug(f"An error occurred while making the request: {e}")
+            # print(f"An error occurred while making the request: {e}")
             return None

src/data_sources/dexscreener.py

@@ -1,10 +1,9 @@
 from dotenv import load_dotenv
 
 import httpx
-from typing import List, Union, Self
-from src.libs.helper_functions import convert_to_snakecase
+from typing import List, Union
 from src.databases.redis import REDIS_CACHED
-from src.libs.constants import ONE_MINUTE_IN_SECONDS
+from src.libs.constants import ONE_HOUR_IN_SECONDS, ONE_MINUTE_IN_SECONDS
 from src.libs.constants import DEX_SCREENER_BASE_URL
 
 load_dotenv()
@@ -51,7 +50,7 @@ class DexScreener:
         try:
             response = httpx.get(url)
             response.raise_for_status()  # Raise an exception if the request was unsuccessful
-            return convert_to_snakecase(response.json())
+            return response.json()
         except httpx.HTTPError as e:
             print(f"An error occurred while making the request: {e}")
             return None
@@ -78,13 +77,13 @@ class DexScreener:
         try:
             response = httpx.get(url)
             response.raise_for_status()  # Raise an exception if the request was unsuccessful
-            return convert_to_snakecase(response.json())
+            return response.json()
         except httpx.HTTPError as e:
             print(f"An error occurred while making the request: {e}")
             return None
         
-    @redis_cache(ttl=ONE_MINUTE_IN_SECONDS)
-    def search_pairs(self, query: str) -> dict:
+    @redis_cache(ttl=ONE_HOUR_IN_SECONDS)
+    def search(self, query: str) -> dict:
         """
         This method is used to search for pairs matching the provided query from Dex Screener API.
         The query may include pair address, token address, token name, or token symbol.
@@ -102,7 +101,7 @@ class DexScreener:
         try:
             response = httpx.get(url)
             response.raise_for_status()  # Raise an exception if the request was unsuccessful
-            return convert_to_snakecase(response.json())
+            return response.json()
         except httpx.HTTPError as e:
             print(f"An error occurred while making the request: {e}")
             return None

src/databases/postgres.py

@@ -0,0 +1,4 @@
+import os
+from sqlalchemy import create_engine
+
+sqlalchemy_engine = create_engine(url=os.getenv('POSTGRES_CONNECTION_STRING'))

src/knowledge_bases/data/coin_data/bnb.json

@@ -0,0 +1,713 @@
+{
+    "Data": {
+        "ID": 8,
+        "TYPE": "162",
+        "ID_LEGACY": 204788,
+        "ID_PARENT_ASSET": null,
+        "SYMBOL": "BNB",
+        "URI": "bnb",
+        "ASSET_TYPE": "BLOCKCHAIN",
+        "PARENT_ASSET_SYMBOL": null,
+        "CREATED_ON": 1661250250,
+        "UPDATED_ON": 1717070963,
+        "PUBLIC_NOTICE": "2024-05-30: The BNB Chain is currently in the final phase of the BNB Smart Chain Feynman Hardfork. This stage involves migrating assets from the BNB Beacon Chain to the BNB Smart Chain (BSC). Previous steps, including enabling native BSC validators, staking, cross-chain stake migration, and governance, have been completed. Stakeholders must take necessary actions before June 2024 to avoid risks associated with this migration process. For more details, visit the [BNB Chain Fusion page](https://www.bnbchain.org/en/bnb-chain-fusion).",
+        "NAME": "Binance Coin",
+        "LOGO_URL": "https://resources.cryptocompare.com/asset-management/8/1661250459982.png",
+        "LAUNCH_DATE": 1555545600,
+        "PREVIOUS_ASSET_SYMBOLS": null,
+        "ASSET_ALTERNATIVE_IDS": [
+            {
+                "NAME": "CMC",
+                "ID": 1839
+            },
+            {
+                "NAME": "CG",
+                "ID": "binancecoin"
+            },
+            {
+                "NAME": "ISIN",
+                "ID": "XT8N2VXJKB15"
+            },
+            {
+                "NAME": "VALOR",
+                "ID": "114384091"
+            },
+            {
+                "NAME": "DTI",
+                "ID": "8N2VXJKB1"
+            }
+        ],
+        "ASSET_DESCRIPTION_SNIPPET": "BNB, created by Changpeng Zhao, is integral to the Binance ecosystem, serving as a versatile utility token within and outside of the Binance platform.",
+        "ASSET_DECIMAL_POINTS": 8,
+        "SUPPORTED_PLATFORMS": [
+            {
+                "BLOCKCHAIN": "MATIC",
+                "TOKEN_STANDARD": "ERC20",
+                "BRIDGE_OPERATOR": "PORTAL_TOKEN_BRIDGE",
+                "IS_ASSET_ISSUER": true,
+                "EXPLORER_URL": "https://polygonscan.com/token/0xecdcb5b88f8e3c15f95c720c51c71c9e2080525d",
+                "SMART_CONTRACT_ADDRESS": "0xecdcb5b88f8e3c15f95c720c51c71c9e2080525d",
+                "LAUNCH_DATE": 1636416000,
+                "TRADING_AS": "WBNB",
+                "DECIMALS": 18
+            },
+            {
+                "BLOCKCHAIN": "SOL",
+                "TOKEN_STANDARD": "SPL",
+                "BRIDGE_OPERATOR": "PORTAL_TOKEN_BRIDGE",
+                "IS_ASSET_ISSUER": true,
+                "EXPLORER_URL": "https://solscan.io/token/9gP2kCy3wA1ctvYWQk75guqXuHfrEomqydHLtcTCqiLa",
+                "SMART_CONTRACT_ADDRESS": "9gP2kCy3wA1ctvYWQk75guqXuHfrEomqydHLtcTCqiLa",
+                "LAUNCH_DATE": 1633910400,
+                "TRADING_AS": "WBNB",
+                "DECIMALS": 8
+            },
+            {
+                "BLOCKCHAIN": "ETH",
+                "TOKEN_STANDARD": "ERC20",
+                "BRIDGE_OPERATOR": "NATIVE_ASSET",
+                "IS_ASSET_ISSUER": true,
+                "EXPLORER_URL": "https://etherscan.io/token/0xB8c77482e45F1F44dE1745F52C74426C631bDD52",
+                "SMART_CONTRACT_ADDRESS": "0xB8c77482e45F1F44dE1745F52C74426C631bDD52",
+                "LAUNCH_DATE": 1499212800,
+                "TRADING_AS": "BNB",
+                "DECIMALS": 18
+            },
+            {
+                "BLOCKCHAIN": "BNB",
+                "TOKEN_STANDARD": "BEP20",
+                "BRIDGE_OPERATOR": "BINANCE_BRIDGE",
+                "IS_ASSET_ISSUER": true,
+                "EXPLORER_URL": "https://bscscan.com/token/0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c",
+                "SMART_CONTRACT_ADDRESS": "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c",
+                "LAUNCH_DATE": 1599091200,
+                "TRADING_AS": "WBNB",
+                "DECIMALS": 18
+            },
+            {
+                "BLOCKCHAIN": "AVAX",
+                "TOKEN_STANDARD": "ERC20",
+                "BRIDGE_OPERATOR": "MULTICHAIN",
+                "IS_ASSET_ISSUER": true,
+                "EXPLORER_URL": "https://snowtrace.io/token/0x264c1383ea520f73dd837f915ef3a732e204a493",
+                "SMART_CONTRACT_ADDRESS": "0x264c1383ea520f73dd837f915ef3a732e204a493",
+                "LAUNCH_DATE": 1623974400,
+                "RETIRE_DATE": 1684627200,
+                "TRADING_AS": "BNB",
+                "DECIMALS": 18
+            },
+            {
+                "BLOCKCHAIN": "WEMIX",
+                "TOKEN_STANDARD": "ERC20",
+                "BRIDGE_OPERATOR": "MULTICHAIN",
+                "IS_ASSET_ISSUER": true,
+                "EXPLORER_URL": "https://explorer.wemix.com/token/0xC1Be9a4D5D45BeeACAE296a7BD5fADBfc14602C4",
+                "SMART_CONTRACT_ADDRESS": "0xC1Be9a4D5D45BeeACAE296a7BD5fADBfc14602C4",
+                "LAUNCH_DATE": 1667433600,
+                "RETIRE_DATE": 1684627200,
+                "TRADING_AS": "BNB",
+                "DECIMALS": 18
+            },
+            {
+                "BLOCKCHAIN": "MOVR",
+                "TOKEN_STANDARD": "ERC20",
+                "BRIDGE_OPERATOR": "MULTICHAIN",
+                "IS_ASSET_ISSUER": true,
+                "EXPLORER_URL": "https://moonriver.moonscan.io/token/0x2bf9b864cdc97b08b6d79ad4663e71b8ab65c45c",
+                "SMART_CONTRACT_ADDRESS": "0x2bf9b864cdc97b08b6d79ad4663e71b8ab65c45c",
+                "LAUNCH_DATE": 1630627200,
+                "RETIRE_DATE": 1684627200,
+                "TRADING_AS": "BNB",
+                "DECIMALS": 18
+            },
+            {
+                "BLOCKCHAIN": "GLMR",
+                "TOKEN_STANDARD": "ERC20",
+                "BRIDGE_OPERATOR": "MULTICHAIN",
+                "IS_ASSET_ISSUER": true,
+                "EXPLORER_URL": "https://moonscan.io/token/0xc9baa8cfdde8e328787e29b4b078abf2dadc2055",
+                "SMART_CONTRACT_ADDRESS": "0xc9baa8cfdde8e328787e29b4b078abf2dadc2055",
+                "LAUNCH_DATE": 1641945600,
+                "RETIRE_DATE": 1684627200,
+                "TRADING_AS": "BNB",
+                "DECIMALS": 18
+            },
+            {
+                "BLOCKCHAIN": "ETC",
+                "TOKEN_STANDARD": "ERC20",
+                "BRIDGE_OPERATOR": "MULTICHAIN",
+                "IS_ASSET_ISSUER": true,
+                "EXPLORER_URL": "https://blockscout.com/etc/mainnet/token/0x0dCb0CB0120d355CdE1ce56040be57Add0185BAa",
+                "SMART_CONTRACT_ADDRESS": "0x0dCb0CB0120d355CdE1ce56040be57Add0185BAa",
+                "LAUNCH_DATE": 1654819200,
+                "RETIRE_DATE": 1684627200,
+                "TRADING_AS": "BNB",
+                "DECIMALS": 18
+            },
+            {
+                "BLOCKCHAIN": "DOGE",
+                "TOKEN_STANDARD": "ERC20",
+                "BRIDGE_OPERATOR": "MULTICHAIN",
+                "IS_ASSET_ISSUER": true,
+                "EXPLORER_URL": "https://explorer.dogechain.dog/token/0xA649325Aa7C5093d12D6F98EB4378deAe68CE23F",
+                "SMART_CONTRACT_ADDRESS": "0xA649325Aa7C5093d12D6F98EB4378deAe68CE23F",
+                "LAUNCH_DATE": 1660780800,
+                "RETIRE_DATE": 1684627200,
+                "TRADING_AS": "BNB",
+                "DECIMALS": 18
+            },
+            {
+                "BLOCKCHAIN": "KAI",
+                "TOKEN_STANDARD": "ERC20",
+                "BRIDGE_OPERATOR": "MULTICHAIN",
+                "IS_ASSET_ISSUER": true,
+                "EXPLORER_URL": "https://explorer.kardiachain.io/token/0xB44a9B6905aF7c801311e8F4E76932ee959c663C",
+                "SMART_CONTRACT_ADDRESS": "0xB44a9B6905aF7c801311e8F4E76932ee959c663C",
+                "LAUNCH_DATE": 1656547200,
+                "RETIRE_DATE": 1684627200,
+                "TRADING_AS": "BNB",
+                "DECIMALS": 18
+            },
+            {
+                "BLOCKCHAIN": "FTM",
+                "TOKEN_STANDARD": "ERC20",
+                "BRIDGE_OPERATOR": "SPOOKYSWAP_BRIDGE",
+                "IS_ASSET_ISSUER": true,
+                "EXPLORER_URL": "https://ftmscan.com/token/0xd67de0e0a0fd7b15dc8348bb9be742f3c5850454",
+                "SMART_CONTRACT_ADDRESS": "0xd67de0e0a0fd7b15dc8348bb9be742f3c5850454",
+                "LAUNCH_DATE": 1620691200,
+                "TRADING_AS": "BNB",
+                "DECIMALS": 18
+            },
+            {
+                "BLOCKCHAIN": "ETH",
+                "TOKEN_STANDARD": "ERC20",
+                "BRIDGE_OPERATOR": "REN_BRIDGE",
+                "IS_ASSET_ISSUER": true,
+                "EXPLORER_URL": "https://etherscan.io/token/0xb8f7762192C840A5E4A6661D5Fa2D4d103E1d16a",
+                "SMART_CONTRACT_ADDRESS": "0xb8f7762192C840A5E4A6661D5Fa2D4d103E1d16a",
+                "LAUNCH_DATE": 1646092800,
+                "TRADING_AS": "RENBNB",
+                "DECIMALS": 18,
+                "IS_INHERITED": true
+            },
+            {
+                "BLOCKCHAIN": "FTM",
+                "TOKEN_STANDARD": "ERC20",
+                "BRIDGE_OPERATOR": "REN_BRIDGE",
+                "IS_ASSET_ISSUER": true,
+                "EXPLORER_URL": "https://ftmscan.com/token/0xb8f7762192C840A5E4A6661D5Fa2D4d103E1d16a",
+                "SMART_CONTRACT_ADDRESS": "0xb8f7762192C840A5E4A6661D5Fa2D4d103E1d16a",
+                "LAUNCH_DATE": 1656979200,
+                "TRADING_AS": "RENBNB",
+                "DECIMALS": 18,
+                "IS_INHERITED": true
+            },
+            {
+                "BLOCKCHAIN": "MATIC",
+                "TOKEN_STANDARD": "ERC20",
+                "BRIDGE_OPERATOR": "REN_BRIDGE",
+                "IS_ASSET_ISSUER": true,
+                "EXPLORER_URL": "https://polygonscan.com/token/0xb8f7762192C840A5E4A6661D5Fa2D4d103E1d16a",
+                "SMART_CONTRACT_ADDRESS": "0xb8f7762192C840A5E4A6661D5Fa2D4d103E1d16a",
+                "LAUNCH_DATE": 1638144000,
+                "TRADING_AS": "RENBNB",
+                "DECIMALS": 18,
+                "IS_INHERITED": true
+            },
+            {
+                "BLOCKCHAIN": "AVAX",
+                "TOKEN_STANDARD": "ERC20",
+                "BRIDGE_OPERATOR": "REN_BRIDGE",
+                "IS_ASSET_ISSUER": true,
+                "EXPLORER_URL": "https://snowtrace.io/token/0xb8f7762192C840A5E4A6661D5Fa2D4d103E1d16a",
+                "SMART_CONTRACT_ADDRESS": "0xb8f7762192C840A5E4A6661D5Fa2D4d103E1d16a",
+                "LAUNCH_DATE": 1638230400,
+                "TRADING_AS": "RENBNB",
+                "DECIMALS": 18,
+                "IS_INHERITED": true
+            }
+        ],
+        "ASSET_CUSTODIANS": [
+            {
+                "NAME": "FIREBLOCKS"
+            },
+            {
+                "NAME": "BITGO"
+            },
+            {
+                "NAME": "MATRIXPORT"
+            },
+            {
+                "NAME": "CACTUS_CUSTODY"
+            },
+            {
+                "NAME": "COBO"
+            },
+            {
+                "NAME": "CYBAVO"
+            },
+            {
+                "NAME": "LEDGER_ENTERPRISE"
+            },
+            {
+                "NAME": "ETANA_CUSTODY"
+            },
+            {
+                "NAME": "BITCOIN_SUISSE"
+            },
+            {
+                "NAME": "COPPER"
+            }
+        ],
+        "CONTROLLED_ADDRESSES": null,
+        "ASSET_SECURITY_METRICS": [
+            {
+                "NAME": "CERTIK",
+                "OVERALL_SCORE": 92.11,
+                "OVERALL_RANK": 35,
+                "UPDATED_AT": 1718236800
+            }
+        ],
+        "SUPPLY_MAX": 100000000,
+        "SUPPLY_ISSUED": 202000000,
+        "SUPPLY_TOTAL": 147584208.501559,
+        "SUPPLY_CIRCULATING": 147584208.50155932,
+        "SUPPLY_FUTURE": 0,
+        "SUPPLY_LOCKED": 0,
+        "SUPPLY_BURNT": 54415791.498441,
+        "SUPPLY_STAKED": null,
+        "LAST_BLOCK_MINT": null,
+        "LAST_BLOCK_BURN": null,
+        "BURN_ADDRESSES": null,
+        "LOCKED_ADDRESSES": null,
+        "HAS_SMART_CONTRACT_CAPABILITIES": true,
+        "SMART_CONTRACT_SUPPORT_TYPE": "ADVANCED_EXECUTION_RIGHTS",
+        "TARGET_BLOCK_MINT": null,
+        "TARGET_BLOCK_TIME": null,
+        "LAST_BLOCK_NUMBER": 376559131,
+        "LAST_BLOCK_TIMESTAMP": null,
+        "LAST_BLOCK_TIME": null,
+        "LAST_BLOCK_SIZE": null,
+        "LAST_BLOCK_ISSUER": null,
+        "LAST_BLOCK_TRANSACTION_FEE_TOTAL": null,
+        "LAST_BLOCK_TRANSACTION_COUNT": null,
+        "LAST_BLOCK_HASHES_PER_SECOND": null,
+        "LAST_BLOCK_DIFFICULTY": null,
+        "SUPPORTED_STANDARDS": [
+            {
+                "NAME": "BEP2"
+            },
+            {
+                "NAME": "BEP20"
+            }
+        ],
+        "LAYER_TWO_SOLUTIONS": [
+            {
+                "NAME": "opBNB",
+                "WEBSITE_URL": "https://opbnb.bnbchain.org/en",
+                "DESCRIPTION": "Developing on opBNB, an optimistic rollup Layer 2 scaling solution for the BNB Smart Chain, is similar to building directly on the BNB Smart Chain itself. opBNB employs an Ethereum Virtual Machine (EVM) execution engine, which allows for easy migration of decentralized applications from Ethereum, BNB Smart Chain, Polygon, and other EVM-compatible chains with minimal code changes.\n\nThe platform scales the BNB Smart Chain by bundling transactions off-chain and using fraud proofs to ensure their validity, leading to significantly higher throughput compared to the underlying chain. This compatibility with the EVM means that any decentralized application (dApp), smart contract, or other application designed for the EVM can operate on opBNB with little to no modifications required.\n\nDevelopers can deploy the same applications on opBNB to benefit from Layer 2 scaling while maintaining the security features of the BNB Smart Chain. This offers the scalability and low costs associated with a rollup solution, combined with the robust security of a Layer 1 platform, providing an efficient environment for dApps to operate effectively.",
+                "CATEGORY": "ROLLUP"
+            },
+            {
+                "NAME": "Boba Network",
+                "WEBSITE_URL": "https://boba.network/",
+                "DESCRIPTION": "The Boba Network, functioning as a multichain Layer 2 optimistic rollup, seeks to harness the capabilities of rollup technology while facilitating interoperability between various blockchains and real-world applications. As a hybrid blockchain, it offers off-chain data and computational resources, making it suitable for the development of sophisticated applications geared towards widespread use. Fully compatible with EVM-based tools, the Boba Network has implemented multichain support for Ethereum, Avalanche, and BNB, providing a platform for rapid transactions and reduced fees.",
+                "CATEGORY": "ROLLUP"
+            }
+        ],
+        "PRIVACY_SOLUTIONS": null,
+        "CODE_REPOSITORIES": [
+            {
+                "URL": "https://github.com/binance-exchange"
+            },
+            {
+                "URL": "https://github.com/binance-exchange/binance-official-api-docs",
+                "OPEN_ISSUES": 2,
+                "CLOSED_ISSUES": 126,
+                "OPEN_PULL_REQUESTS": 0,
+                "CLOSED_PULL_REQUESTS": 126,
+                "CONTRIBUTORS": 0,
+                "FORKS": 2136,
+                "STARS": 3832,
+                "SUBSCRIBERS": 499,
+                "LAST_UPDATED_TS": 1690372964,
+                "LAST_PUSH_TS": 1682283934,
+                "CODE_SIZE_IN_BYTES": 1,
+                "IS_FORK": false,
+                "LANGUAGE": null,
+                "FORKED_ASSET_DATA": null
+            },
+            {
+                "URL": "https://github.com/binance-exchange/binance-api-node",
+                "OPEN_ISSUES": 1,
+                "CLOSED_ISSUES": 25,
+                "OPEN_PULL_REQUESTS": 0,
+                "CLOSED_PULL_REQUESTS": 25,
+                "CONTRIBUTORS": 102,
+                "FORKS": 176,
+                "STARS": 568,
+                "SUBSCRIBERS": 44,
+                "LAST_UPDATED_TS": 1690375176,
+                "LAST_PUSH_TS": 1686157630,
+                "CODE_SIZE_IN_BYTES": 739,
+                "IS_FORK": true,
+                "LANGUAGE": "JavaScript",
+                "FORKED_ASSET_DATA": null
+            },
+            {
+                "URL": "https://github.com/binance-exchange/go-binance",
+                "OPEN_ISSUES": 9,
+                "CLOSED_ISSUES": 10,
+                "OPEN_PULL_REQUESTS": 9,
+                "CLOSED_PULL_REQUESTS": 10,
+                "CONTRIBUTORS": 3,
+                "FORKS": 102,
+                "STARS": 214,
+                "SUBSCRIBERS": 22,
+                "LAST_UPDATED_TS": 1690375177,
+                "LAST_PUSH_TS": 1595796163,
+                "CODE_SIZE_IN_BYTES": 1599,
+                "IS_FORK": true,
+                "LANGUAGE": "Go",
+                "FORKED_ASSET_DATA": null
+            },
+            {
+                "URL": "https://github.com/binance-exchange/node-binance-api",
+                "OPEN_ISSUES": 18,
+                "CLOSED_ISSUES": 214,
+                "OPEN_PULL_REQUESTS": 0,
+                "CLOSED_PULL_REQUESTS": 109,
+                "CONTRIBUTORS": 82,
+                "FORKS": 150,
+                "STARS": 521,
+                "SUBSCRIBERS": 42,
+                "LAST_UPDATED_TS": 1690372966,
+                "LAST_PUSH_TS": 1682296247,
+                "CODE_SIZE_IN_BYTES": 1217,
+                "IS_FORK": true,
+                "LANGUAGE": "JavaScript",
+                "FORKED_ASSET_DATA": null
+            },
+            {
+                "URL": "https://github.com/binance-exchange/python-binance",
+                "OPEN_ISSUES": 4,
+                "CLOSED_ISSUES": 0,
+                "OPEN_PULL_REQUESTS": 4,
+                "CLOSED_PULL_REQUESTS": 0,
+                "CONTRIBUTORS": 21,
+                "FORKS": 182,
+                "STARS": 452,
+                "SUBSCRIBERS": 68,
+                "LAST_UPDATED_TS": 1690372967,
+                "LAST_PUSH_TS": 1531807102,
+                "CODE_SIZE_IN_BYTES": 347,
+                "IS_FORK": true,
+                "LANGUAGE": "Python",
+                "FORKED_ASSET_DATA": null
+            },
+            {
+                "URL": "https://github.com/binance-exchange/binance-java-api",
+                "OPEN_ISSUES": 154,
+                "CLOSED_ISSUES": 281,
+                "OPEN_PULL_REQUESTS": 41,
+                "CLOSED_PULL_REQUESTS": 97,
+                "CONTRIBUTORS": 43,
+                "FORKS": 640,
+                "STARS": 826,
+                "SUBSCRIBERS": 97,
+                "LAST_UPDATED_TS": 1690375177,
+                "LAST_PUSH_TS": 1686147366,
+                "CODE_SIZE_IN_BYTES": 440,
+                "IS_FORK": true,
+                "LANGUAGE": "Java",
+                "FORKED_ASSET_DATA": null
+            }
+        ],
+        "SUBREDDITS": [
+            {
+                "URL": "https://reddit.com/r/binance",
+                "MAKE_3RD_PARTY_REQUEST": true,
+                "NAME": "binance",
+                "CURRENT_ACTIVE_USERS": 43,
+                "AVERAGE_POSTS_PER_DAY": 0.22,
+                "AVERAGE_POSTS_PER_HOUR": 0.01,
+                "AVERAGE_COMMENTS_PER_DAY": 18.05,
+                "AVERAGE_COMMENTS_PER_HOUR": 0.75,
+                "SUBSCRIBERS": 904498,
+                "COMMUNITY_CREATED_AT": 1498873536,
+                "LAST_UPDATED_TS": 1718367530
+            }
+        ],
+        "TWITTER_ACCOUNTS": [
+            {
+                "URL": "https://twitter.com/binance",
+                "MAKE_3RD_PARTY_REQUEST": true,
+                "NAME": "Binance",
+                "USERNAME": "binance",
+                "VERIFIED": true,
+                "VERIFIED_TYPE": "business",
+                "FOLLOWING": 0,
+                "FOLLOWERS": 10858205,
+                "FAVOURITES": 0,
+                "LISTS": 29826,
+                "STATUSES": 29219,
+                "ACCOUNT_CREATED_AT": 1498120695,
+                "LAST_UPDATED_TS": 1698775503
+            }
+        ],
+        "DISCORD_SERVERS": [
+            {
+                "URL": "https://discord.com/invite/jE4wt8g2H2",
+                "MAKE_3RD_PARTY_REQUEST": false,
+                "NAME": "Binance",
+                "TOTAL_MEMBERS": 91925,
+                "CURRENT_ACTIVE_USERS": 7886,
+                "PREMIUM_SUBSCRIBERS": 25,
+                "LAST_UPDATED_TS": 1691075162
+            }
+        ],
+        "TELEGRAM_GROUPS": [
+            {
+                "URL": "https://t.me/BNBchaincommunity",
+                "MAKE_3RD_PARTY_REQUEST": false,
+                "NAME": "BNB Chain Community",
+                "USERNAME": "BNBchaincommunity",
+                "MEMBERS": 118577,
+                "LAST_UPDATED_TS": 1695279793
+            }
+        ],
+        "OTHER_SOCIAL_NETWORKS": [
+            {
+                "NAME": "FACEBOOK",
+                "URL": "https://www.facebook.com/binance"
+            },
+            {
+                "NAME": "INSTAGRAM",
+                "URL": "https://www.instagram.com/Binance/"
+            },
+            {
+                "NAME": "YOUTUBE",
+                "URL": "https://www.youtube.com/binanceyoutube"
+            },
+            {
+                "NAME": "LINKEDIN",
+                "URL": "https://www.linkedin.com/company/binance"
+            }
+        ],
+        "HELD_TOKEN_SALE": true,
+        "TOKEN_SALES": [
+            {
+                "TOKEN_SALE_TYPE": "ICO",
+                "TOKEN_SALE_DATE_START": 1498435200,
+                "TOKEN_SALE_DATE_END": 1499040000,
+                "TOKEN_SALE_DESCRIPTION": "Binance held its ICO on the 26th of June, with the ICO supply representing half of the total 200M token supply, thus selling 100,000,000 BNB tokens and raising $15,000,000. The ICO ended on the 3rd of July. The issue price was 1 ETH for 2,700 BNB or 1 BTC for 20,000 BNB (around 0.11 USD back then).",
+                "TOKEN_SALE_TEAM_MEMBERS": [
+                    {
+                        "TYPE": "EMPLOYEE",
+                        "FULL_NAME": "Changpeng Zhao"
+                    },
+                    {
+                        "TYPE": "EMPLOYEE",
+                        "FULL_NAME": "Roger Wang"
+                    },
+                    {
+                        "TYPE": "EMPLOYEE",
+                        "FULL_NAME": "James Hofbauer"
+                    },
+                    {
+                        "TYPE": "EMPLOYEE",
+                        "FULL_NAME": "Paul Jankunas"
+                    }
+                ],
+                "TOKEN_SALE_WEBSITE_URL": "https://www.binance.com/",
+                "TOKEN_SALE_SUPPLY": 100000000,
+                "TOKEN_SUPPLY_POST_SALE": "DECREASES",
+                "TOKEN_SALE_PAYMENT_METHOD_TYPE": "CRYPTO",
+                "TOKEN_SALE_START_PRICE": 0.15,
+                "TOKEN_SALE_START_PRICE_CURRENCY": "USD",
+                "TOKEN_SALE_FUNDS_RAISED": [
+                    {
+                        "CURRENCY": "BNB",
+                        "TOTAL_VALUE": 100000000,
+                        "DESCRIPTION": "Out of the total 200 million BNB token supply, 100 million BNB coins were sold during the ICO at a Binance ICO price of 2,700 BNB for 1 ETH"
+                    }
+                ],
+                "TOKEN_SALE_FUNDS_RAISED_USD": 15000000,
+                "TOKEN_SALE_INVESTORS_SPLIT": [
+                    {
+                        "CATEGORY": "PUBLIC",
+                        "TOTAL_TOKENS": 50000000
+                    }
+                ],
+                "TOKEN_SALE_RESERVE_SPLIT": [
+                    {
+                        "CATEGORY": "TEAM",
+                        "TOTAL_TOKENS": 80000000
+                    },
+                    {
+                        "CATEGORY": "TEAM",
+                        "TOTAL_TOKENS": 20000000
+                    }
+                ],
+                "TOKEN_SALE_JURISDICTIONS": [
+                    {
+                        "NAME": "KY"
+                    }
+                ],
+                "TOKEN_SALE_LEGAL_FORMS": [
+                    {
+                        "NAME": "CORPORATION"
+                    }
+                ]
+            }
+        ],
+        "HELD_EQUITY_SALE": false,
+        "WEBSITE_URL": "https://www.binance.com/",
+        "BLOG_URL": "https://www.binance.com/en/blog",
+        "WHITE_PAPER_URL": "https://resources.cryptocompare.com/asset-management/8/1661250302524.pdf",
+        "OTHER_DOCUMENT_URLS": [
+            {
+                "TYPE": "TOKEN_ECONOMICS",
+                "VERSION": 1,
+                "URL": "https://resources.cryptocompare.com/asset-management/8/1664528054778.pdf",
+                "COMMENT": "\"Tokenomics Deep Dive\""
+            },
+            {
+                "TYPE": "AUDIT",
+                "URL": "https://resources.cryptocompare.com/asset-management/8/1702984453160.pdf",
+                "COMMENT": "Certik audit"
+            },
+            {
+                "TYPE": "AUDIT",
+                "URL": "https://resources.cryptocompare.com/asset-management/8/1702984652594.pdf",
+                "COMMENT": "Hacken audit"
+            },
+            {
+                "TYPE": "ROADMAP",
+                "URL": "https://resources.cryptocompare.com/asset-management/8/1703172228924.pdf",
+                "COMMENT": "Uploaded 21/12/2023"
+            },
+            {
+                "TYPE": "ROADMAP",
+                "URL": "https://resources.cryptocompare.com/asset-management/8/1703172721792.pdf",
+                "COMMENT": "BNB Chain Fusion Roadmap"
+            },
+            {
+                "TYPE": "ESG_REPORT",
+                "URL": "https://resources.cryptocompare.com/asset-management/8/1703174584333.pdf",
+                "COMMENT": "Governance of BSC"
+            },
+            {
+                "TYPE": "ESG_REPORT",
+                "URL": "https://resources.cryptocompare.com/asset-management/8/1703174851909.pdf",
+                "COMMENT": "Governance of BNB Beacon Chain"
+            }
+        ],
+        "EXPLORER_ADDRESSES": [
+            {
+                "URL": "https://explorer.bnbchain.org/"
+            },
+            {
+                "URL": "https://bscscan.com/"
+            },
+            {
+                "URL": "https://binance.mintscan.io/"
+            },
+            {
+                "URL": "https://explorer.bitquery.io/bsc"
+            },
+            {
+                "URL": "https://bsctrace.com/"
+            },
+            {
+                "URL": "https://www.oklink.com/bsc"
+            },
+            {
+                "URL": "https://getblock.io/explorers/bsc/"
+            },
+            {
+                "URL": "https://blockchair.com/bnb"
+            },
+            {
+                "URL": "https://bsc.tokenview.io/"
+            },
+            {
+                "URL": "https://bnb.dex.guru/"
+            }
+        ],
+        "ASSET_INDUSTRIES": [
+            {
+                "ASSET_INDUSTRY": "PLATFORM"
+            },
+            {
+                "ASSET_INDUSTRY": "BRIDGE_OPERATOR"
+            },
+            {
+                "ASSET_INDUSTRY": "PAYMENTS"
+            }
+        ],
+        "CONSENSUS_MECHANISMS": [
+            {
+                "NAME": "POS"
+            },
+            {
+                "NAME": "POA"
+            }
+        ],
+        "CONSENSUS_ALGORITHM_TYPES": [
+            {
+                "NAME": "Tendermint BFT",
+                "DESCRIPTION": "Binance Chain relies on the Tendermint BFT consensus and Delegated Proof of Stake (DPoS) with a dedicated application layer that runs upon it. As of today, the vote delegation feature is not open for users.\n\nBinance Chain is built on forks of Tendermint and Cosmos SDK. Specifically, Binance Chain is made on a revised edition of the Tendermint consensus while leveraging its P2P networking logic.\n\nAt any given state, the following information is being recorded:\n\n- Account and balances: the balance (i.e., the number of tokens) of each asset is composed of 3 different parts: locked, frozen, and available. It is recorded on all accounts.\n- Fees: it represents how much fees were paid in the previous block.\n- Token information: what are the tokens, along with their respective information (frozen supply, etc.)\n- Trading pairs: the list of all the trading pairs on Binance DEX.\n- Tick size and lot size: various information related to the trading engine of Binance DEX.\n- Governance information: information about the validators, and governance mechanism of the Binance Chain."
+            },
+            {
+                "NAME": "Proof-of-Staked Authority (PoSA)",
+                "DESCRIPTION": "The Binance Smart Chain combines several features from Delegated Proof-of-Stake (DPoS) and Proof-of-Authority (PoA) for consensus finding.\n\nAt its core, this consensus algorithm called Parlia is built on a network of 21 validators and delegators, who vote for validators.\n\nIn Binance Smart Chain, any party can attempt to become a validator, assuming they meet (1) the hardware requirement to run the network, (2) manage their own keys, (3) guarantee a high uptime and (4) own and stake at least 20,000 BNB. Similar to other DPoS blockchains, BSC validators receive network fees for validating blocks.\n\nAs of writing, the top 21 validators with the largest number of BNBs staked are selected every day and eligible to validate and produce blocks on the Binance Smart Chain. \n\nDelegators can vote for validators, allocating BNB to increase the validator\u2019s capacity to produce blocks, while receiving some of the rewards from network fees. This election is repeated every 24 hours. At the end of the period, the staking status decides what the top 21 highest nodes with votes to become the validator set for the next period are.\n\nIn addition, Binance Smart Chain introduces a slashing mechanism to prevent bad behaviour and other issues: e.g., prevent double signatures, penalties for being offline, etc.\n\nFor instance, BSC\u2019s slashing mechanism allows any individual to submit a \u201cslashing request\u201d on Binance Chain, assuming they are able to bring the proof that the malicious validator produced two block headers with the same height and parent block."
+            }
+        ],
+        "HASHING_ALGORITHM_TYPES": [
+            {
+                "NAME": "SHA_256"
+            }
+        ],
+        "PRICE_USD": 605.351392574596,
+        "PRICE_USD_SOURCE": "cadli",
+        "PRICE_USD_LAST_UPDATE_TS": 1718377245,
+        "MKT_CAP_PENALTY": 0,
+        "CIRCULATING_MKT_CAP_USD": 89340306138.43848,
+        "TOTAL_MKT_CAP_USD": 89340306138.43828,
+        "SPOT_MOVING_24_HOUR_QUOTE_VOLUME_TOP_TIER_DIRECT_USD": 5717.5208552127,
+        "SPOT_MOVING_24_HOUR_QUOTE_VOLUME_DIRECT_USD": 681557.540655213,
+        "SPOT_MOVING_24_HOUR_QUOTE_VOLUME_TOP_TIER_USD": 337790572.034656,
+        "SPOT_MOVING_24_HOUR_QUOTE_VOLUME_USD": 507742353.298955,
+        "SPOT_MOVING_24_HOUR_CHANGE_USD": 8.158248751072,
+        "SPOT_MOVING_24_HOUR_CHANGE_PERCENTAGE_USD": 1.3660988635667999,
+        "TOPLIST_BASE_RANK": {
+            "LAUNCH_DATE": 4601,
+            "CIRCULATING_MKT_CAP_USD": 4,
+            "TOTAL_MKT_CAP_USD": 4,
+            "SPOT_MOVING_24_HOUR_QUOTE_VOLUME_USD": 8,
+            "SPOT_MOVING_24_HOUR_CHANGE_PERCENTAGE_USD": 1037
+        },
+        "ASSET_DESCRIPTION": "## What is Binance Coin (BNB)?\nBinance Coin, known as BNB, is the cryptocurrency token that powers the BNB Chain ecosystem. Initially referred to as Binance Coin, it plays a central role in the functionalities of the Binance ecosystem, which includes the world's largest cryptocurrency exchange by volume. BNB operates as a utility token, allowing users to trade it like any other cryptocurrency. Furthermore, BNB is used in a variety of applications and use cases, extending its utility beyond mere trading. The Binance Chain, supporting BNB, uses a Byzantine Fault Tolerance (BFT) consensus mechanism for fast and efficient transaction processing.\n\nBinance is a cryptocurrency exchange platform. It offers a variety of services including cryptocurrency trading, digital asset management, and various blockchain-based offerings. Binance is known for supporting a wide array of cryptocurrencies for trading. The platform also provides features like crypto-to-crypto trading, staking, and an option for users to participate in initial coin offerings (ICOs) and token sales. The exchange is designed to cater to both beginner and experienced traders, offering a range of tools and functionalities tailored to different levels of expertise in the cryptocurrency market.\n\n## What is Binance Coin (BNB) used for?\nBNB was initially used mainly to pay for trading and transaction fees on the Binance cryptocurrency exchange. Over time, its utility has expanded significantly. Today, BNB is used in various applications within and outside the Binance ecosystem, showcasing its versatility as a utility token. The token's role in facilitating various transactions and activities within the Binance ecosystem has been a key factor in its widespread adoption and use. Additionally, the introduction of the Binance Smart Chain, a parallel blockchain, has enabled smart contract functionality and interoperability, further expanding BNB's use cases.\n\n## Who created Binance Coin (BNB)?\nBinance Coin (BNB) was founded in 2017 by Changpeng Zhao, a tech entrepreneur commonly referred to as CZ. He established BNB as the native utility token of the Binance exchange. The BNB Chain employs a unique combination of Proof of Stake (PoS) and Proof of Authority (PoA) consensus mechanisms to validate network transactions, contributing to the security and efficiency of the ecosystem.",
+        "ASSET_DESCRIPTION_SUMMARY": "Binance Coin (BNB) is a cryptocurrency token central to the Binance ecosystem, including the world's largest cryptocurrency exchange. Created by Changpeng Zhao in 2017, BNB has evolved from a tool for paying transaction fees on the Binance exchange to a widely used utility token in various applications. Its importance in the Binance ecosystem is underscored by its role in facilitating transactions and activities across the platform.",
+        "PROJECT_LEADERS": [
+            {
+                "LEADER_TYPE": "FOUNDER",
+                "FULL_NAME": "Changpeng Zhao"
+            },
+            {
+                "LEADER_TYPE": "FOUNDER",
+                "FULL_NAME": "Yi He"
+            }
+        ],
+        "ASSOCIATED_CONTACT_DETAILS": [
+            {
+                "CONTACT_MEDIUM": "EMAIL_ADDRESS"
+            }
+        ],
+        "SEO_TITLE": "Binance Coin (BNB)",
+        "SEO_DESCRIPTION": "Live Binance Coin price movements from all markets and BNB market cap, use our charts and see when there is an opportunity to buy or sell."
+    },
+    "Err": {}
+}

src/knowledge_bases/data/coin_data/pepe.json

@@ -0,0 +1,158 @@
+{
+    "Data": {
+        "ID": 3010,
+        "TYPE": "162",
+        "ID_LEGACY": 953245,
+        "ID_PARENT_ASSET": null,
+        "SYMBOL": "PEPE",
+        "URI": "pepe",
+        "ASSET_TYPE": "TOKEN",
+        "PARENT_ASSET_SYMBOL": null,
+        "CREATED_ON": 1683799924,
+        "UPDATED_ON": 1709050507,
+        "PUBLIC_NOTICE": null,
+        "NAME": "Pepe",
+        "LOGO_URL": "https://resources.cryptocompare.com/asset-management/3010/1709049889749.png",
+        "LAUNCH_DATE": 1681430400,
+        "PREVIOUS_ASSET_SYMBOLS": null,
+        "ASSET_ALTERNATIVE_IDS": [
+            {
+                "NAME": "CG",
+                "ID": "pepe"
+            },
+            {
+                "NAME": "CMC",
+                "ID": 24478
+            }
+        ],
+        "ASSET_DESCRIPTION_SNIPPET": "$PEPE is an ERC-20 token, known as the most memeable memecoin, embracing the internet meme Pepe's popularity. Unlike other meme-based cryptocurrencies, it launched stealthily without presale or taxes, aiming to be a coin for the people.",
+        "SUPPORTED_PLATFORMS": [
+            {
+                "BLOCKCHAIN": "ETH",
+                "TOKEN_STANDARD": "ERC20",
+                "BRIDGE_OPERATOR": "NATIVE_ASSET",
+                "IS_ASSET_ISSUER": true,
+                "EXPLORER_URL": "https://etherscan.io/token/0x6982508145454Ce325dDbE47a25d4ec3d2311933",
+                "SMART_CONTRACT_ADDRESS": "0x6982508145454Ce325dDbE47a25d4ec3d2311933",
+                "LAUNCH_DATE": 1681430400,
+                "TRADING_AS": "PEPE",
+                "DECIMALS": 18
+            }
+        ],
+        "ASSET_CUSTODIANS": null,
+        "CONTROLLED_ADDRESSES": null,
+        "ASSET_SECURITY_METRICS": [
+            {
+                "NAME": "CERTIK",
+                "OVERALL_SCORE": 86.87,
+                "OVERALL_RANK": 211,
+                "UPDATED_AT": 1718409600
+            }
+        ],
+        "SUPPLY_MAX": -1,
+        "SUPPLY_ISSUED": 420689899999995,
+        "SUPPLY_TOTAL": 420689899999995,
+        "SUPPLY_CIRCULATING": 420689899999995,
+        "SUPPLY_FUTURE": -1,
+        "SUPPLY_LOCKED": 0,
+        "SUPPLY_BURNT": 0,
+        "SUPPLY_STAKED": null,
+        "BURN_ADDRESSES": null,
+        "LOCKED_ADDRESSES": null,
+        "CODE_REPOSITORIES": null,
+        "SUBREDDITS": null,
+        "TWITTER_ACCOUNTS": [
+            {
+                "URL": "https://twitter.com/pepecoineth",
+                "NAME": "Pepe",
+                "USERNAME": "pepecoineth",
+                "FOLLOWING": 1,
+                "FOLLOWERS": 413507,
+                "FAVOURITES": 254,
+                "LISTS": 458,
+                "STATUSES": 407,
+                "ACCOUNT_CREATED_AT": 1680625027,
+                "LAST_UPDATED_TS": 1689344201
+            }
+        ],
+        "DISCORD_SERVERS": [
+            {
+                "URL": "https://discord.com/invite/pepe-palace",
+                "MAKE_3RD_PARTY_REQUEST": false,
+                "NAME": "\ud83d\udc38Pepe Palace\ud83d\udc38",
+                "TOTAL_MEMBERS": 16821,
+                "CURRENT_ACTIVE_USERS": 1262,
+                "PREMIUM_SUBSCRIBERS": 14,
+                "LAST_UPDATED_TS": 1688912388
+            }
+        ],
+        "TELEGRAM_GROUPS": [
+            {
+                "URL": "https://t.me/pepecoineth"
+            }
+        ],
+        "OTHER_SOCIAL_NETWORKS": null,
+        "HELD_TOKEN_SALE": false,
+        "HELD_EQUITY_SALE": false,
+        "WEBSITE_URL": "https://www.pepe.vip/",
+        "BLOG_URL": null,
+        "WHITE_PAPER_URL": null,
+        "OTHER_DOCUMENT_URLS": [
+            {
+                "TYPE": "ROADMAP",
+                "URL": "https://resources.cryptocompare.com/asset-management/3010/1683800472809.png"
+            },
+            {
+                "TYPE": "TOKEN_ECONOMICS",
+                "URL": "https://resources.cryptocompare.com/asset-management/3010/1683800517243.png"
+            },
+            {
+                "TYPE": "AUDIT",
+                "URL": "https://resources.cryptocompare.com/asset-management/3010/1699438872469.pdf",
+                "COMMENT": "Pepe-Token-Audit-Report 2023-08-21"
+            },
+            {
+                "TYPE": "AUDIT",
+                "URL": "https://resources.cryptocompare.com/asset-management/3010/1709050208378.pdf",
+                "COMMENT": "Certik audit"
+            }
+        ],
+        "ASSET_INDUSTRIES": [
+            {
+                "ASSET_INDUSTRY": "PLATFORM"
+            },
+            {
+                "ASSET_INDUSTRY": "PAYMENT"
+            },
+            {
+                "ASSET_INDUSTRY": "BRIDGE_OPERATOR"
+            }
+        ],
+        "PRICE_USD": 1.23046108057731e-05,
+        "PRICE_USD_SOURCE": "cadli",
+        "PRICE_USD_LAST_UPDATE_TS": 1718570876,
+        "MKT_CAP_PENALTY": null,
+        "CIRCULATING_MKT_CAP_USD": 5176425489.419543,
+        "TOTAL_MKT_CAP_USD": 5176425489.419543,
+        "SPOT_MOVING_24_HOUR_QUOTE_VOLUME_TOP_TIER_DIRECT_USD": 4732463.87575718,
+        "SPOT_MOVING_24_HOUR_QUOTE_VOLUME_DIRECT_USD": 15781091.0909223,
+        "SPOT_MOVING_24_HOUR_QUOTE_VOLUME_TOP_TIER_USD": 335538908.468033,
+        "SPOT_MOVING_24_HOUR_QUOTE_VOLUME_USD": 425993603.001758,
+        "SPOT_MOVING_24_HOUR_CHANGE_USD": 4.714449013124e-07,
+        "SPOT_MOVING_24_HOUR_CHANGE_PERCENTAGE_USD": 3.9840977902175903,
+        "TOPLIST_BASE_RANK": {
+            "LAUNCH_DATE": 10706,
+            "CIRCULATING_MKT_CAP_USD": 23,
+            "TOTAL_MKT_CAP_USD": 38,
+            "SPOT_MOVING_24_HOUR_QUOTE_VOLUME_USD": 7,
+            "SPOT_MOVING_24_HOUR_CHANGE_PERCENTAGE_USD": 614
+        },
+        "ASSET_DESCRIPTION": "## What is Pepe (PEPE)?\n\nPepe (PEPE) is a digital currency positioned as the next step in the evolution of meme coins, leveraging the memetic power of Pepe, a recognizable internet meme. Launched without any presale or taxes, PEPE aims to be a coin for the people, with its liquidity provider tokens burned and contract renounced.\n\n## Who created Pepe?\n\nThe specific creator of Pepe (PEPE) is not mentioned, but it is clarified that it is not associated with Matt Furie or his creation Pepe the Frog. Instead, it pays homage to the meme character.\n\n## What is $PEPE used for?\n\nThe PEPE token serves as a meme coin with no intrinsic value or financial return expectation. It follows a roadmap with phases like getting listed on popular crypto platforms, community partnerships, launching Pepe Times newsletter, token-gated Discord group, and plans for Pepe merchandise and academy. PEPE is intended to be entirely useless and solely for entertainment purposes.",
+        "ASSET_DESCRIPTION_SUMMARY": "Pepe (PEPE) is a digital currency that positions itself as the next step in meme coin evolution, leveraging the memetic power of the internet meme Pepe. Launched without presale or taxes, it aims to be a coin for the people, with liquidity provider tokens burned and contract renounced. The token has a roadmap with different phases, including community partnerships, launching a digital newsletter, and getting listed on exchanges. However, it's important to note that PEPE is not associated with Pepe the Frog and is intended to be entirely useless and for entertainment purposes only.",
+        "PROJECT_LEADERS": null,
+        "ASSOCIATED_CONTACT_DETAILS": null,
+        "SEO_TITLE": "Pepe (PEPE)",
+        "SEO_DESCRIPTION": "Live Pepe price movements from all markets and PEPE market cap, use our charts and see when there is an opportunity to buy or sell."
+    },
+    "Err": {}
+}

src/knowledge_bases/json_knowledge_base.py

@@ -0,0 +1,12 @@
+from phi.knowledge.json import JSONKnowledgeBase
+from phi.vectordb.pgvector import PgVector2
+from src.databases.postgres import sqlalchemy_engine
+
+json_knowledge_base = JSONKnowledgeBase(
+    path="data/json",
+    # Table name: ai.json_documents
+    vector_db=PgVector2(
+        collection="json_documents",
+        db_engine=sqlalchemy_engine
+    ),
+)

src/knowledge_bases/knowledge_base.py

@@ -0,0 +1,17 @@
+from phi.knowledge.combined import CombinedKnowledgeBase
+from phi.vectordb.pgvector import PgVector2
+from src.knowledge_bases.json_knowledge_base import json_knowledge_base
+from src.databases.postgres import sqlalchemy_engine
+
+knowledge_base = CombinedKnowledgeBase(
+    sources=[
+        json_knowledge_base,
+        # website_knowledge_base,
+        # local_pdf_knowledge_base,
+    ],
+    vector_db=PgVector2(
+        # Table name: ai.combined_documents
+        collection="combined_documents",
+        db_engine=sqlalchemy_engine
+    ),
+)

src/knowledge_bases/store_data.py

@@ -0,0 +1,10 @@
+from src.data_sources.cryptocompare import CryptoCompare
+from src.libs.helper_functions import store_json_data
+from src.libs.logger import logger
+
+ccp = CryptoCompare()
+
+def store_coin_data(id: str):
+    result = ccp.get_overall_coin_data(symbol=id)
+    store_json_data(result, f"data/coin_data/{id}.json")
+    logger.debug(f"Data stored for {id}")

src/libs/constants.py

@@ -1,15 +1,20 @@
 """
-Constants representing the nuumber of seconds in a week.
+Constants representing the number of seconds in a quarter.
+"""
+ONE_QUARTER_IN_SECONDS : int = (86400 * 30) * 3
+
+"""
+Constants representing the number of seconds in a month.
 """
 ONE_MONTH_IN_SECONDS : int = 86400 * 30
 
 """
-Constants representing the nuumber of seconds in a week.
+Constants representing the number of seconds in a week.
 """
 ONE_WEEK_IN_SECONDS : int = 604800
 
 """
-Constants representing the nuumber of seconds in a day.
+Constants representing the number of seconds in a day.
 """
 ONE_DAY_IN_SECONDS : int = 86400
 
@@ -24,36 +29,40 @@ Constant representing the number of seconds in one minute.
 ONE_MINUTE_IN_SECONDS : int = 60
 
 """
-DEX_SCREENER_BASE_URL : str = "https://api.dexscreener.com/latest/dex/"
-
 This constant is used to represent the base URL for DexScreener API.
-It is defined as "https://api.dexscreener.com/latest/dex/".
+
+DEX_SCREENER_BASE_URL : str
 """
 DEX_SCREENER_BASE_URL : str = "https://api.dexscreener.com/latest/dex/"
 
 """
-JINA_SEARCH_BASE_ENDPOINT : str = "https://s.jina.ai/"
-
 This constant is used to represent the base endpoint for Jina Search API.
-It is defined as "https://s.jina.ai/".
+
+JINA_SEARCH_BASE_ENDPOINT : str
 """
 JINA_SEARCH_BASE_ENDPOINT : str = "https://s.jina.ai/"
 
 """
-JINA_READER_BASE_ENDPOINT : str = "https://r.jina.ai/"
-
 This constant is used to represent the base endpoint for Jina Reader API.
-It is defined as "https://r.jina.ai/".
+
+JINA_READER_BASE_ENDPOINT : str
 """
 JINA_READER_BASE_ENDPOINT : str = "https://r.jina.ai/"
 
 """
-CRYPTO_COMPARE_BASE_URL: str = "https://min-api.cryptocompare.com/"
-
 This constant is used to represent the base URL for CryptoCompare API.
-It is defined as "https://min-api.cryptocompare.com/".
+
+CRYPTO_COMPARE_BASE_URL: str
+"""
+CRYPTO_COMPARE_API_BASE_URL: str = "https://min-api.cryptocompare.com/"
+
+
+"""
+This constant is used to represent the base URL for CryptoCompare  asset data API.
+
+CRYPTO_COMPARE_ASSET_DATA_API_BASE_URL: str
 """
-CRYPTO_COMPARE_BASE_URL: str = "https://min-api.cryptocompare.com/"
+CRYPTO_COMPARE_ASSET_DATA_API_BASE_URL : str = "https://data-api.cryptocompare.com/asset/v1/"
 
 
 # TTLs

src/libs/helper_functions.py

@@ -1,3 +1,4 @@
+import os
 import re
 import uuid
 import hashlib
@@ -130,4 +131,19 @@ def convert_to_snakecase(original_data):
     elif isinstance(original_data, list):
         return [convert_to_snakecase(item) for item in original_data]
     else:
-        raise TypeError("Input must be a dictionary or a list of dictionaries.")
+        raise TypeError("Input must be a dictionary or a list of dictionaries.")
+    
+import json
+
+def store_json_data(data, output_file):
+    try:
+        # Create directory if it doesn't exist
+        os.makedirs(os.path.dirname(output_file), exist_ok=True)
+
+        # Write the JSON data to a file
+        with open(output_file, 'w') as file:
+            json.dump(data, file, indent=4)
+        
+        print(f"Data successfully stored in {output_file}")
+    except Exception as e:
+        print(f"An error occurred: {e}")

src/tools/coin_data_toolkit.py

@@ -5,13 +5,18 @@ from phi.utils.log import logger
 
 from src.data_sources.coin_gecko import CoinGecko
 from src.data_sources.cryptocompare import CryptoCompare
+from src.data_sources.dexscreener import DexScreener
 
 class CryptoDataTools(Toolkit):
     def __init__(self):
         super().__init__(name="crypto_data_tools")
+        
         self.register(self.get_coin_price)
+        self.register(self.get_coin_data)
+
         self.coingecko = CoinGecko()
         self.crypto_compare = CryptoCompare()
+        self.dex_screener = DexScreener()
 
     def get_coin_price(self, coin_id: str, vs_currency: str = "usd") -> str:
         """
@@ -51,10 +56,39 @@ class CryptoDataTools(Toolkit):
             else:
                 logger.warning(f"Warning: CryptoCompare data for {coin_id} not found.")
 
-            logger.debug(f"respons {coingecko_price}")
-            logger.debug(f"respons {crypto_compare_price}")
+            logger.debug(f"response {coingecko_price}")
+            logger.debug(f"response {crypto_compare_price}")
             
             return f"{(coingecko_price, crypto_compare_price)}"
         except Exception as e:
             logger.warning(f"Failed to fetch price data for {coin_id}: {e}")
             return f"Error: {e}"
+        
+    def get_coin_data(self, coin_symbol: str) -> str:
+        """
+        Fetches coin data for a given cryptocurrency coin from DexScreener and CryptoCompare.
+
+        Args:
+        coin_symbol (str): The symbol for the cryptocurrency coin.
+
+        Returns:
+        str: A JSON string containing the coin data from DexScreener and CryptoCompare for the specified coin.
+
+        Raises:
+        Exception: If an error occurs while fetching the coin data.
+
+        Example:
+        >>> get_coin_data("BTC")
+        """
+        logger.info(f"Fetching coin data for {coin_symbol} cryptocurrency coin")
+        try:
+            dexscreener_coin_data = self.dex_screener.search(query=coin_symbol)
+            cryptocompare_coin_data = self.crypto_compare.get_overall_coin_data(symbol=coin_symbol)
+
+            logger.debug(f"dexscreener_coin_data: {dexscreener_coin_data}")
+            logger.debug(f"cryptocompare_coin_data: {cryptocompare_coin_data}")
+
+            return f"{(dexscreener_coin_data, cryptocompare_coin_data)}"
+        except Exception as e:
+            logger.warning(f"Failed to fetch coin data for {coin_symbol}: {e}")
+            return f"Error: {e}"