​
Getting Started with POND3R

This guide will help you quickly get started with POND3R’s web app and API to access Web3 data through natural language.

​
Using the Web3 Data Chat

The Web3 Data Chat is the easiest way to start exploring blockchain data without any technical setup.

1

Navigate to the chat interface

Go directly to makeit.pond3r.xyz.

2

Ask your first question

Type a natural language question in the chat box, such as:

What are the top 5 Uniswap pools on Base by volume in the last 24 hours?

or

What's the current price of ETH?
3

Review the response

POND3R will process your question, find the relevant data sources, and return a human-readable answer with visualizations when applicable.

4

Refine your query

You can ask follow-up questions to drill down into the data. For example:

How has the volume changed compared to last week?

POND3R maintains context from previous questions to provide more relevant answers.

​
Connecting to the API

For developers looking to integrate POND3R’s capabilities into their applications:

1

Get your API key

Navigate to “Settings” > “API Keys” in your POND3R dashboard and click “Generate New Key”. Give your key a name (e.g., “Development Key”) and click “Create”.

Keep your API key secure and never expose it in client-side code. We recommend using environment variables to store your key.

2

Submit your first query

Use the following code example to submit a query to the POND3R API:

const axios = require('axios');

async function submitQuery() {
  try {
    const response = await axios.post('https://api.pond3r.xyz/v1/messages', {
      prompt: 'Get the current price of ETH'
    }, {
      headers: {
        'x-api-key': 'YOUR_API_KEY',
        'Content-Type': 'application/json'
      }
    });
    
    return response.data.processingId;
  } catch (error) {
    console.error('Error submitting query:', error.response ? error.response.data : error.message);
    throw error;
  }
}
3

Check the processing status

After submitting your query, you’ll receive a processingId. Use this ID to check the status of your request:

async function getResult(processingId) {
  try {
    const response = await axios.get(`https://api.pond3r.xyz/v1/messages/${processingId}/status`, {
      headers: {
        'x-api-key': 'YOUR_API_KEY'
      }
    });
    
    return response.data;
  } catch (error) {
    console.error('Error checking status:', error.response ? error.response.data : error.message);
    throw error;
  }
}

// Example of waiting for the result
async function waitForResult(processingId, maxAttempts = 30, interval = 2000) {
  for (let attempt = 0; attempt < maxAttempts; attempt++) {
    const status = await getResult(processingId);
    
    if (status.status === 'FINISHED') {
      return status.result;
    } else if (status.status === 'ERROR') {
      throw new Error(status.errorMessage || 'Processing failed');
    }
    
    // Wait before next attempt
    await new Promise(resolve => setTimeout(resolve, interval));
  }
  
  throw new Error('Timeout waiting for result');
}
4

Handle the response

The API returns responses in this format:

{
  "status": "FINISHED",
  "result": {
    "result": "The current price of ETH is $2088.21 as of March 24, 2024.",
    "status": "success"
  }
}

The status endpoint can return the following statuses:

  • PENDING: The message has been received and is waiting to be processed
  • PROCESSING: The message is currently being processed
  • FINISHED: Processing is complete and the result is available
  • ERROR: An error occurred during processing

Always implement proper error handling and retry logic. We recommend using a polling interval of 2-3 seconds between status checks.

​
Next steps

Now that you’ve made your first queries with POND3R, you can:

Explore Query Examples

See examples of effective queries for different types of blockchain data

Browse Available Data

Learn what chains, protocols, and data types POND3R can access

Read API Documentation

Get detailed information about API endpoints and parameters