Skip to content

API_REFERENCE.md

Latest commit

 

History

History
89 lines (70 loc) · 1.46 KB

API_REFERENCE.md

File metadata and controls

89 lines (70 loc) · 1.46 KB
Raw

Vialpump REST API Reference

The Vialpump API provides read-only access to the live mint feed, global state, and user entitlement caching.

Base URL: https://api.vialpump.fun

GET /health

Check the health of the listener engine and transaction queue.

Response:

  • 200 OK
{
  "status": "ok",
  "queueSize": 12
}

GET /api/wallet/{address}/vials

Fetch all Pixel Vials currently owned by a specific Solana address. Note: This endpoint acts as a proxy wrapper around the Solana Digital Asset Standard (DAS) API.

Parameters:

Name In Type Required Description
address path string Yes The base58 Solana wallet address

Response:

  • 200 OK
{
  "wallet": "ABC...XYZ",
  "vial_count": 2,
  "vials": [
    {
      "edition": 257,
      "asset_id": "cNFT_address_here",
      "traits": {
        "meme": "Pepe",
        "peptide": "BPC-157",
        "rarity": "Common"
      }
    }
  ]
}

GET /api/feed/live

Retrieve the 100 most recent mint or burn events to populate a live feed.

Response:

  • 200 OK
[
  {
    "edition": 892,
    "wallet_address": "DEF...123",
    "action": "mint",
    "burned_at": null,
    "created_at": "2026-05-02T12:00:00Z"
  }
]

GET /api/stats

Retrieve global protocol statistics.

Response:

  • 200 OK
{
  "circulating": 5420,
  "burned": 120,
  "holders": 850,
  "volume_sol": 1240.5
}