API Docs — Koschei

Koschei API Docs

Reference for the public Web3 endpoints and member tools available in Koschei.

Overview

Koschei exposes REST endpoints for Solana-focused developer workflows, read-only risk checks, live chain health, and member account operations. Responses are JSON unless otherwise noted.

Base URL: https://your-koschei-domain.example

Authentication

Public health endpoints can be called directly. Member endpoints require a signed-in Koschei session from the web app.

Area	Requirement
Public API	No private keys, seed phrases, or wallet custody are required.
Member tools	Use your Koschei account session before calling member-only routes.

GET /api/web3/health?chain=solana

Chain health

Returns the current health status for a supported blockchain network.

Query	Description
`chain`	One of `solana`, `ethereum`, `base`, `arbitrum`, `polygon`, or `optimism`.

fetch('/api/web3/health?chain=solana')
  .then((res) => res.json())
  .then(console.log);

POST /api/metadata

Metadata generation

Generate structured project, NFT, or game asset metadata from your prompt and project details.

fetch('/api/metadata', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ name: 'Example Collection', chain: 'solana' })
});

POST /api/risk

Risk scanner

Submit a public project, wallet, or contract reference to review read-only Web3 risk signals.

fetch('/api/risk', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ target: 'public-address-or-project-url' })
});

GET /api/watchlist

Watchlist

Track public wallet or contract activity with Alchemy-powered polling from the Koschei member hub.

fetch('/api/watchlist')
  .then((res) => res.json())
  .then(console.log);