OpenViSTAI · Agents · Blockchain · Crypto
Submit a project
Menu
DeFi

Geckoterminal API

Geckoterminal API is an MIT-licensed Python wrapper for GeckoTerminal’s DeFi and decentralized-exchange data API, offering synchronous and asynchronous interfaces for retrieving market and pool information.

Explore the practical guide ↓

Independent OpenViST project profile, based on linked sources.

Geckoterminal API — OpenViST project profile in DeFi.
OpenViST project illustration. See the linked sources for product details.
Understand the project

Practical overview

When it fits

Use it when a Python script or application needs to collect GeckoTerminal market or pool data without building the data-access calls directly into that application.

Who it is for

  • Python developers building data collectors for GeckoTerminal markets.
  • Analysts integrating DEX market information into Python applications.

Documented uses

  • Retrieve token prices, volume and historical chart data.
  • Find pools that trade a token and discover trending or newly created pools.
  • Fetch trade records for a specified pool.
  • Use synchronous or asynchronous calls in a Python data workflow.
Before you choose

Requirements & limits

The README documents installation from PyPI with `pip install geckoterminal-api` and indicates Python 3.12 or later.

  • The README identifies the API as beta and subject to change.
  • The package exposes both synchronous and asynchronous client interfaces.
  • The repository lists an MIT license.

Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.

Source-based practical guide

Install the package and make a network-list request

Set up the library and follow the documented synchronous quickstart to request supported networks and their IDs.

Before you start

  • Python 3.12 or later, as indicated by the project README.
  • A Python environment with the package installed.

Steps

  1. Install the package with the command below.

    Documented command
    pip install geckoterminal-api

  2. Import GeckoTerminalAPI from geckoterminal_api.

  3. Create an instance with gt = GeckoTerminalAPI().

  4. Call gt.networks() to request supported networks and their IDs.

Expected outcome

The documented quickstart makes a synchronous request for the supported networks and their IDs.

Guide limitations

  • The project describes the API as beta and subject to change.
  • The README links to GeckoTerminal API documentation for further details.
Documentation 1 ↗
Source-based practical guide

Retrieve trades for a specified pool

Use the synchronous client to request and print trade timestamps, buy-or-sell kinds and USD volumes for a specified Solana pool.

Before you start

  • The package installed in a Python environment.
  • A network name and pool address; the README example uses solana and a specific pool address.

Steps

  1. Create a synchronous client with gt = GeckoTerminalAPI().

  2. Call gt.network_pool_trades(network="solana", pool="69grLw4PcSypZnn3xpsozCJFT8vs8WA5817VUVnzNGTh").

  3. Iterate through the response's data entries and read each entry's attributes.

  4. Print the block_timestamp, kind and volume_in_usd fields as shown in the README example.

Expected outcome

The example processes trade records for the specified pool, including timestamps, trade direction and USD volume.

Guide limitations

  • The project labels the API beta and subject to change.
  • The example concerns one specified Solana pool; it does not document the result for other pool addresses.
Documentation 1 ↗
Evidence and transparency

Sources & review

Official repository ↗
Source record details
Source availability
Active
Sources checked
15 October 2026
Original website title
dineshpinto/geckoterminal-api · Official homepage title · retained in its source language
How we review sourcesSuggest a correction