Public API Reference

Direct access to SagaDAO's snapshot data. Our API provides fast, cached access to holder information for Seeker and Saga Genesis collections.

Get Holders

            GET
            /api/public/holders
        

Retrieves a list of wallets holding the specified collection NFTs. Data is updated periodically via our snapshot system.

Query Parameters

Parameter	Type	Required	Description
type	string	Yes	Collection type. Must be either `'saga'` or `'seeker'`.
wallet	string	No	Filter results for a specific wallet address.
limit	number	No	Maximum number of records to return. Default is 1000.

Example Request

# cURL example
curl "https://www.sagadaobot.app/api/public/holders?type=saga&limit=5"
        

// JavaScript / Node.js
const fetch = require('node-fetch');

async function getHolders() {
    const response = await fetch('https://www.sagadaobot.app/api/public/holders?type=seeker&limit=10');
    const data = await response.json();
    console.log(data);
}

getHolders();
        

# Python
import requests

response = requests.get('https://www.sagadaobot.app/api/public/holders', params={
    'type': 'saga',
    'limit': 10
})

data = response.json()
print(data)
        

Response Structure

{
  "success": true,
  "count": 1,
  "limit": 5,
  "data": [
    {
      "wallet_address": "HeH3...92a1",
      "amount": 1,
      "last_updated": "2025-01-09T18:30:00.000Z"
    }
  ]
}
        

Error Responses

If the request fails, the API returns a JSON object with success: false and an error message.

{
  "success": false,
  "error": "Invalid type parameter. Must be 'saga' or 'seeker'"
}
        