Skip to main content

Endpoint Showcase

Discover how Pesto API is used at pestoai.fun and docs.pestoai.fun.

Table of Contents​

  1. Ping
  2. Users
  3. Auth
  4. Simple
  5. Coins
  6. Contract
  7. Categories
  8. Asset Platform
  9. Exchanges
  10. Exchange Rates
  11. Derivatives
  12. Search
  13. Trending
  14. Global

Ping​

  • GET /v2/ping
    • Description: Check API server status. A successful response with a status of "OK" indicates that the server is operational.

Simple​

  • GET /v2/simple/price

    • Description: Retrieves the latest price of cryptocurrencies in various supported fiat and crypto currencies. This endpoint provides a simple and lightweight way to fetch real-time prices without additional market data. The response includes the current price, timestamp, and the selected currency conversions. Ideal for quick price checks and integrations requiring minimal data.

  • GET /v2/simple/token_price/{id}

    • Description: Fetches the latest price of a token using its contract address for a specific blockchain. This allows users to query the current valuation of a token deployed on Ethereum, Binance Smart Chain, Polygon, and other supported networks. The response provides token price data in different currencies, ensuring flexibility for users tracking DeFi or ERC-20 tokens.

  • GET /v2/simple/supported_vs_currencies

    • Description: Returns a comprehensive list of all fiat and cryptocurrency currencies supported for price conversions. This endpoint is useful for applications needing to dynamically generate conversion options or display supported trading pairs. It includes popular fiat currencies like USD, EUR, and JPY, as well as crypto assets like BTC, ETH, and USDT.

Coins​

  • GET /v2/coins/list

    • Description: Provides a full list of all cryptocurrencies supported by the API, along with their unique identifiers. This endpoint is essential for applications that need to display available crypto assets or allow users to search for coins by name or symbol. The response includes the coin’s id, symbol, and name, which can be used to fetch further details in other endpoints.

  • GET /v2/coins/markets

    • Description: Retrieves detailed market data for a list of supported cryptocurrencies, including real-time pricing, market capitalization, trading volume, and price percentage changes over different time frames. The response also includes liquidity indicators such as circulating supply, total supply, and 24-hour trading activity. This endpoint is particularly useful for tracking live market trends and integrating market data into dashboards or trading applications.

  • GET /v2/coins/{id}

    • Description: Provides comprehensive real-time data for a specific cryptocurrency, identified by its unique id. The response includes essential details such as the coin’s market rank, current price, historical performance, liquidity, available exchanges, and community-driven data like developer activity and social media metrics. This endpoint is perfect for obtaining an in-depth overview of a coin's performance.

  • GET /v2/coins/{id}/tickers

    • Description: Retrieves a paginated list of tickers (trading pairs) associated with a specific cryptocurrency. Each ticker includes details such as the exchange name, trading pair, latest price, trading volume, and spread. This endpoint is valuable for users who want to compare trading activity across different exchanges and find the best liquidity sources for a specific cryptocurrency.

  • GET /v2/coins/{id}/history

    • Description: Returns historical market data for a cryptocurrency at a specific date in the past. This includes price data, market capitalization, and total volume for that day. It allows users to analyze past trends, track performance over time, and make historical comparisons. The endpoint is commonly used for research and retrospective price analysis.

  • GET /v2/coins/{id}/market_chart

    • Description: Provides historical market data for a cryptocurrency over a specified time period, including price trends, market capitalization changes, and 24-hour trading volume. The data is returned in a format suitable for generating time-series charts and analyzing price movements. This endpoint is useful for traders, analysts, and platforms displaying historical price trends.

  • GET /v2/coins/{id}/market_chart/range

    • Description: Retrieves historical market data within a specific timestamp range, offering granular price, volume, and market cap data. Unlike /market_chart, this endpoint allows users to define custom time intervals, making it useful for tracking long-term trends or analyzing short-term fluctuations over a precise date range.

  • GET /v2/coins/{id}/ohlc

    • Description: Provides Open, High, Low, and Close (OHLC) data for a cryptocurrency. OHLC data is essential for technical analysis and charting applications, helping traders identify trends, resistance levels, and market reversals. The endpoint supports different timeframes, allowing users to retrieve OHLC data for hourly, daily, or weekly intervals.

Contract​

  • GET /v2/coins/{id}/contract/{contract_address}

    • Description: Retrieves detailed information about a cryptocurrency token using its smart contract address on a specific blockchain. This is useful for fetching metadata such as the token's name, symbol, total supply, and market data. It supports Ethereum, Binance Smart Chain, Polygon, and other networks, helping users track the details of ERC-20, BEP-20, and other token standards.

  • GET /v2/coins/{id}/contract/{contract_address}/market_chart

    • Description: Provides historical market data for a token identified by its contract address. The response includes price trends, market capitalization, and trading volume data over a specified period. This endpoint is ideal for tracking the performance of DeFi tokens, stablecoins, and altcoins that exist solely on blockchain contracts.

  • GET /v2/coins/{id}/contract/{contract_address}/market_chart/range

    • Description: Retrieves historical market data for a token within a custom timestamp range. The response includes granular price, volume, and market cap data, allowing users to conduct in-depth token analysis. This endpoint is particularly useful for traders and analysts who need to compare performance across different time frames or identify trends in token liquidity and valuation.

Categories​

  • GET /v2/coins/categories/list

    • Description: Returns a list of all available cryptocurrency categories. Categories group cryptocurrencies based on their use cases, such as DeFi, NFTs, Layer 1 protocols, and Metaverse tokens. This endpoint helps users explore the ecosystem of digital assets by providing insights into different sectors within the cryptocurrency market.

  • GET /v2/coins/categories

    • Description: Retrieves a list of cryptocurrency categories along with relevant market data, including total market capitalization, trading volume, and price movement. This endpoint is useful for tracking sector-wide trends and identifying which categories are experiencing significant growth or decline in market value.

Asset Platform​

  • GET /v2/asset_platforms

    • Description: Lists all blockchain networks (asset platforms) that support tokenized assets. This includes popular blockchains like Ethereum, Binance Smart Chain, Solana, and Avalanche. The response provides details such as the network name, native token, and associated contract address standards. This endpoint is useful for developers building cross-chain applications or tracking assets across multiple blockchains.

Exchanges​

  • GET /v2/exchanges

    • Description: Returns a list of all active cryptocurrency exchanges, including centralized (CEX) and decentralized (DEX) exchanges. Each entry includes the exchange name, trust score, trading volume, and other relevant statistics. This endpoint is useful for users looking to compare different exchanges based on liquidity and reliability.

  • GET /v2/exchanges/list

    • Description: Retrieves a simplified list of all supported cryptocurrency exchanges by name and ID. Unlike the /exchanges endpoint, this response does not include detailed trading volume or market statistics. It is useful for quickly referencing exchange identifiers when making API requests.

  • GET /v2/exchanges/{id}

    • Description: Provides market data for a specific cryptocurrency exchange, identified by its unique id. The response includes total exchange volume (measured in BTC), the number of supported markets, and additional trading statistics. This endpoint helps users assess the liquidity and activity of a given exchange.

  • GET /v2/exchanges/{id}/tickers

    • Description: Retrieves the latest trading pairs and tickers for a specific exchange. The response includes details such as the base and quote currencies, last traded price, 24-hour trading volume, and percentage price changes. This endpoint is useful for monitoring liquidity across different trading pairs and identifying arbitrage opportunities.

  • GET /v2/exchanges/{id}/volume_chart

    • Description: Returns historical trading volume data for a specific exchange over a 24-hour rolling period. The data is provided in BTC, allowing users to track trends in exchange liquidity and activity. This endpoint is valuable for analyzing how trading volume fluctuates over time and identifying peak trading hours.

Exchange Rates​

  • GET /v2/exchange_rates

    • Description: Retrieves the latest Bitcoin (BTC) to various fiat and cryptocurrency exchange rates. This endpoint provides real-time conversion values between BTC and major currencies like USD, EUR, JPY, and stablecoins, as well as other cryptocurrencies. It's useful for financial applications, trading platforms, and users who need accurate and up-to-date conversion rates for their transactions.

Derivatives​

  • GET /v2/derivatives

    • Description: Lists all available derivative tickers, including futures and perpetual contracts. The response includes details such as the contract pair, price, funding rate, open interest, and 24-hour trading volume. This endpoint is useful for traders looking to analyze derivative markets and track movements in leverage-based trading.

  • GET /v2/derivatives/exchanges

    • Description: Retrieves a list of all derivative exchanges, including platforms that support futures, options, and perpetual contracts. Each exchange entry includes trading volume, open interest, and available derivative markets. This endpoint is ideal for users comparing different platforms for leveraged trading.

  • GET /v2/derivatives/exchanges/{id}

    • Description: Fetches detailed derivative market data for a specific exchange identified by {id}. The response includes available trading pairs, funding rates, open interest, and contract specifications. This is useful for users analyzing derivative trading conditions on a particular platform.

  • GET /v2/derivatives/exchanges/list

    • Description: Returns a simplified list of all derivative exchanges by name and identifier. Unlike the /derivatives/exchanges endpoint, this response does not include trading volume or detailed statistics. It serves as a quick reference for identifying exchange IDs when making API requests.

  • GET /v2/search

    • Description: Enables users to search for cryptocurrency-related information, including specific coins, categories, and markets. The response includes matching asset names, tickers, and relevant metadata. This endpoint is helpful for discovering new assets, tracking niche markets, or finding details about a specific cryptocurrency.

  • GET /v2/search/trending

    • Description: Returns the top 7 trending cryptocurrencies based on search volume and user interest in the last 24 hours. This endpoint helps users track which digital assets are gaining popularity, often signaling potential market movements or emerging trends in the crypto space.

Global​

  • GET /v2/global

    • Description: Retrieves aggregated global cryptocurrency market data, including total market capitalization, trading volume, and market sentiment indicators. This endpoint provides a macroeconomic view of the crypto industry, helping analysts and traders assess overall market conditions.

  • GET /v2/global/decentralized_finance_defi

    • Description: Fetches data specific to the decentralized finance (DeFi) sector, including total value locked (TVL), lending, borrowing, and DeFi token market capitalization. This endpoint is useful for tracking DeFi trends and evaluating the adoption and growth of decentralized financial applications.