Developers

Flexible queries with precise field selection. Query blocks, transactions, events, tokens, addresses, network stats, and custom indexed events.

const res = await fetch("https://beta.tamsa.io/api/graphql", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "your-api-key",
  },
  body: JSON.stringify({
    query: `{
      blocks(limit: 5) {
        number hash miner txCount timestamp
      }
      transactions(address: "0x...", limit: 10) {
        hash from to value status methodName
      }
      networkStats {
        blockHeight avgBlockTime totalTransactions
      }
    }`,
  }),
});

Try it live in the GraphQL Playground

Standard REST endpoints for all blockchain data. Returns indexed data first, falls back to RPC.

// Block detail
const block = await fetch("https://beta.tamsa.io/api/blocks/33000000")
  .then(r => r.json());

// Recent transactions from an address
const txs = await fetch("https://beta.tamsa.io/api/transactions?from=0x...&count=20")
  .then(r => r.json());

// XP price from on-chain oracle
const price = await fetch("https://beta.tamsa.io/api/price")
  .then(r => r.json());
// { price: 0.00633, exchanges: [...], confidence: 0.00002 }

// Token holders
const token = await fetch("https://beta.tamsa.io/api/tokens/0x...")
  .then(r => r.json());

Server-Sent Events for real-time data. Sub-second latency via PostgreSQL LISTEN/NOTIFY.

// Stream new blocks
const source = new EventSource("https://beta.tamsa.io/api/stream/blocks");
source.onmessage = (e) => {
  const block = JSON.parse(e.data);
  console.log(`Block #${block.number}: ${block.txCount} txs`);
};

// Stream events from a contract
const events = new EventSource(
  "https://beta.tamsa.io/api/stream/events?address=0x...&eventName=Transfer"
);

Ask natural language questions about the blockchain. 32 AI tools for blocks, mining, oracle, tokens, and more. Also available as an MCP server for Claude Desktop, Cursor, and other AI agents.

// AI Chat (streaming)
const res = await fetch("https://beta.tamsa.io/api/chat", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    messages: [{ role: "user", content: "Top 5 miners this week" }]
  })
});

// MCP — add to claude_desktop_config.json:
{
  "mcpServers": {
    "xphere": { "url": "https://beta.tamsa.io/api/mcp" }
  }
}