IQ GPT is an AI-powered assistant for blockchain knowledge developed by IQ.wiki, the largest blockchain encyclopedia.
IQ GPT was launched in 2023 by IQ.wiki to help users access real-time and reliable crypto information from a wide range of sources. It caters to various use cases, including learning, development, and trading activities. IQ GPT streamlines research processes, filters out irrelevant data, and offers contextually specific content for users seeking accurate and up-to-date information in the blockchain domain.
IQ GPT is powered by the IQ token and pulls data from various sources such as IQ.wiki's extensive database, DeFiLlama, Frax Docs, Binance Academy, DeFi Protocol Documentations, The Associated Press News, CoinGecko, Flywheel DeFi, BlockBeats, InvestHK and CoinNess. On October 12, 2023, the BrainDAO team introduced IQ GPT chat functionalities. The AI assistant was enhanced with the ability to conduct conversations, allowing for interactive dialogues with users, including asking follow-up questions. A new chat history feature was also added, enabling users to organize their interactions by creating distinct categories such as trading and researching. In late 2023, the BrainDAO team introduced the IQ GPT Chat, designed to support Telegram and Discord communities involved in cryptocurrency, DeFi, NFTs, and related topics. According to IQ v3, released on November 1, 2023, the team's vision is to build a version of IQ GPT Chat for dapps and websites like decentralized exchanges, DeFi applications, cryptocurrency projects, NFT projects, data platforms, and more.

Overview of IQ GPT Integrations

  1. 1.
    IQ.wiki - IQ.wiki, formerly known as Everipedia, is the largest blockchain and cryptocurrency encyclopedia globally. IQ GPT integrates IQ.wiki's extensive database to provide high-quality responses to millions of potential prompts about crypto and blockchain-related topics. Example prompts:
"Who created Cardano?" "What NFT-based games have Yuga Labs released?"
  1. 2.
    CoinGecko - CoinGecko is a cryptocurrency data aggregation and tracking website that offers a comprehensive overview of digital currencies and market analytics. IQ GPT utilizes CoinGecko's premium market data APIs to provide up-to-date and accurate information about cryptocurrencies, NFT projects, and exchanges. Example prompts: "What is the current price of Ethereum?" "Create a list of the tokens that saw the greatest increase in price this year with over $100 million market cap"
  2. 3.
    Flywheel DeFi - Flywheel DeFi is a platform that focuses on creating high-quality DeFi content with a particular emphasis on Frax Finance. IQ GPT pulls reliable source data from Flywheel DeFi's articles revolving around DeFi projects. Example prompts: "What is frax?" "What is barbell investment theory?"
  3. 4.
    InvestHK - InvestHK (Invest Hong Kong) is the department of the Hong Kong SAR Government responsible for Foreign Direct Investment. IQ GPT leverages InvestHK's data to provide information and support for overseas businesses looking to set up and expand in Hong Kong. Example prompts: "What did Phillips Auctioneers Ltd announced?" "What is the summary of seminar conducted by ​Invest Hong Kong (InvestHK) and Xinjiang government?"
  4. 5.
    CoinNess - CoinNess is a crypto and blockchain information platform that delivers real-time coverage and insights into the crypto and blockchain worlds. IQ GPT uses CoinNess data to provide users with instant and comprehensive information about cryptocurrency markets and events. Example prompts: "What is Viver?" "What did Puzzle Monsters win?"
  5. 6.
    DeFiLlama - DefiLlama is an aggregator of Total Value Locked (TVL) in the decentralized finance (DeFi) field. Its data is open-source and overseen by a team of contributors representing numerous protocols. DeFi Llama offers data on cryptocurrencies, encompassing current price levels, along with Total Value Locked (TVL) information for various DeFi sectors such as decentralized exchanges (DEXs), lending protocols, yield farming operations, staking pools, DeFi insurance, and other related products.
Example prompts:

Technical Background

To facilitate the answer-generation process, we maintain a map of tools that are passed to the agent. This dynamic tool management allows us to select tools based on the user's preferences and debug options efficiently. We basically have 2 major tools Vector Query tool and Coingecko Tool. And langchain's calculator tool.

Vector Query Tool

Vector Query Tool enables users to retrieve answers from indexed partner sources. This tool plays a crucial role in providing contextually relevant information to users.

Goals for this tool

  1. 1.
    Top 5 Results: The Vector Query Tool is designed to accept user prompts and return the top 5 results from indexed sources. These results include the source name and source URL.
  2. 2.
    DebugOptions Filtering: It selectively returns results only from sources that align with the user's specified debug options.

How it works

  1. 1.
    User Prompt: The tool begins by taking in a user prompt.
  2. 2.
    Source Selection: It searches the vector database, considering the user's debug options, to retrieve data from selected sources.
  3. 3.
    Top 5 Results: The tool compiles the top 5 results and passes them to the agent as tool output, contributing to the final answer generation process.

Coingecko Tool

Coingecko Tool is instrumental in answering crypto market-related prompts based on real-time data. This tool provides users with up-to-date information about cryptocurrency markets.

Goals for this tool

  1. 1.
    Endpoint Selection: The Coingecko Tool is designed to understand user questions and select the most appropriate endpoint for answering the prompt. It constructs valid Coingecko API endpoints based on the user's input.
  2. 2.
    Data Retrieval: It can call various Coingecko API endpoints to gather relevant data and return it as the final response.
  3. 3.
    Data Filtering: To prevent max token limit errors from LLM, the tool ensures that it only returns the necessary data required for the answer, even when dealing with large datasets.

How it works

  1. 1.
    Endpoint Selection System: This system is responsible for choosing the best endpoint to answer the prompts based on tool input. It narrows down the options from around 30 endpoints to a more manageable number.
  2. 2.
    Dynamic Functions Generation: To support different sets of 10 endpoints and provide input parameters for the selected endpoint, this system dynamically generates functions JSON, ensuring flexibility in endpoint selection.
  3. 3.
    Enums System: For input parameters that require selection from a list of values, the Enums System ensures that LLM selects values correctly from the list, reducing the chances of errors.
  4. 4.
    Data Filtering System: This system filters the data retrieved from Coingecko API to return only the essential information, adapting to the specific requirements of different endpoints.
  5. 5.
    Function Wrapping System: Some endpoints require complex data filtering, and the Function Wrapping System wraps these endpoints with functions that include filtering in the final endpoint selection step. This approach streamlines the process for challenging data sets.

Endpoint and example prompts

We use x endpoints provided by coingecko api. The following are the endpoints(paths) and example prompt which the endpoint is suitable and selected to answer the prompt
  1. 1.
    /simple/price : This endpoint allows you to retrieve the current price of one or more cryptocurrencies in a specified target currency from Coingecko. Example prompts - "What is price of IQ Token"
  2. 2.
    /simple/token_price/ : This endpoint enables you to fetch the current price of a specific token with a contract address Example prompts - "what is price of token with contract address 0x579CEa1889991f68aCc35Ff5c3dd0621fF29b0C9"
  3. 3.
    /simple/supported_vs_currencies : This endpoint enables you to get the supported currencies in IQ GPT Example prompts - "What are the supported currencies in IQ GPT?"
  4. 4.
    /coins/list/new : This endpoint enables you to get list of newly added coins Example prompts - "List newly added coins to coingecko"
  5. 5.
    /coins/markets : This endpoint enables you to get all coins market data. But practically using this endpoint is not possible because the response schema has lot of fields which LLM cant handle and throws token max error
  6. 6.
    /coins/{id} : This endpoint enables you to get detailed information about a specific cryptocurrency based on its unique id. Example prompts : "Give me details information about IQ Token" (Remember to set the sources to only Coingecko in debug panel since remaining sources will have information about cryptocurrency but that is static)
  7. 7.
    /coins/{id}/history : This endpoint enables you to get the price of cryptocurrency at a point of date in history Example prompts : "What is price of IQ Token on 28 July 2023"
  8. 8.
    /coins/{id}/contract/{contract_address} : This endpoint enables you to get the details about the contract address Example prompts : "contract details for contract address 0x579CEa1889991f68aCc35Ff5c3dd0621fF29b0C9"
  9. 9.
    /coins/{id}/ohlc : This endpoint enables you to get the open, high, low, close of any listed cryptocurrency Example prompts : "Give ohlc of IQ Token"
  10. 10.
    /asset_platforms : This endpoints get you all the asset platforms listed on coingecko Example prompts : "List all the asset platforms in coingecko"
  11. 11.
    /coins/categories : This endpoint gives all the categories of the coins listed in coingecko Example prompts : "List all the categories for the coins listed in coingecko"
  12. 12.
    /exchanges : This endpoints gives you all the listed endpoints in coingecko Example prompts : "Give all the exchanges listed in coingecko"
  13. 13.
    /exchanges/{id}/volume_chart: This endpoint allows you to retrieve volume chart data (in BTC) for a given exchange. Example prompts : "Give me volume chart of binance for past 7 days" (But practically using this endpoint is not possible because the response schema has lot of fields which LLM cant handle and throws token max error)
  14. 14.
    /search/trending : endpoint provides a list of the top trending search coins on CoinGecko in the last 24 hours Example prompts : "What are trending coins on coingecko"
  15. 15.
    /companies/public_treasury/{coin_id} : This endpoint allows you to retrieve data about public companie's Bitcoin or Ethereum holdings Example prompts : "How much public companies are holding in ethereum?"

Function Wrapper/Custom Endpoints with example prompts

  1. 1.
    coin_market_chart : This function wrapper enables you to fetch historical market prices and data for a specific cryptocurrency Example prompts : "What is the average price of bitcoin between 28 july 2023 and 29 August 2023"
  2. 2.
    get_multi_exchange_prices_for_coin : This function wrapper helps you to fetch prices from an exchange for multiple coin ids Example prompts : "What is price of ethereum in binance and upbit ? What is the price difference between both exchanges?"
  3. 3.
    get_volume_by_range_exchange : This function wrapper helps you to get the trading volume of exchange between given time range(upto 31 days) Example prompts : "List the trading volume of Binance between 28-07-203 to 3-08-2023"
For more information on IQ GPT see the IQ GPT wiki page on IQ.wiki. For early access to IQ GPT, you need to maintain a HiIQ balance of 100,000 HiIQ. Your HiIQ balance is based on the amount of IQ you’ve staked in addition to the amount of time you’ve locked your IQ which naturally decreases over time. Therefore we recommend having over 100,000 HiIQ for example if you lock 100,000 IQ for 2 years you would have 200,000 HiIQ. It would take 2 years for your HiIQ balance to drop to 100,000 HiIQ allowing you to use IQ GPT for 2 years.
In addition to early access to IQ GPT, IQ stakers will also in the future have access to premium features. Stakers earn IQ tokens and have a say in governance with their voting power based on their HiIQ balance. To learn how to stake IQ check out the HiIQ guide. If you haven’t staked IQ you can sign up for the waitlist using this form.