Skip to content
View MPP32's full-sized avatar

Block or report MPP32

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
MPP32/README.md

MPP32

Real-time Solana token intelligence, built on the Machine Payments Protocol.

CI License: MIT Release Platform Solana Follow on X

mpp32.org  ·  Playground  ·  Docs  ·  Build on MPP32  ·  Roadmap


MPP32 is an open infrastructure layer for Solana token data, starting with a built-in intelligence oracle. Query any token by contract address or ticker and receive an 8-dimensional on-chain analysis in under two seconds — no API keys, no subscriptions. Callers pay per query through the Machine Payments Protocol (HTTP 402).

For builders, MPP32 doubles as a deployment platform: register any existing API endpoint, set a per-query price, and MPP32 wraps it with a full payment layer. Your service appears in the open ecosystem directory and earns revenue from day one.


What the Oracle returns

Field Description
alphaScore 0–100 composite signal strength
riskRewardRatio Potential upside vs downside at current price
smartMoneySignals On-chain behavioral patterns from significant wallets
pumpProbability24h Estimated probability of a notable price move in 24h
projectedROI Low/high ROI range with estimated timeframe
whaleActivity Recent buy/sell pressure from large holders
rugRisk 0–10 score with specific risk factors identified
marketData Price changes, volume, liquidity, pair age, FDV

All 8 dimensions are returned in a single response. Data is sourced live from DexScreener, Jupiter, and CoinGecko and scored in real time — no cached responses, no stale data.


Quick start

Try the Playground

The fastest path: head to mpp32.org/playground, paste any Solana contract address or ticker, and hit Run Query. No wallet needed for the demo.

Call the demo endpoint

curl -X POST https://mpp32.org/api/intelligence/demo \
  -H "Content-Type: application/json" \
  -d '{ "token": "SOL" }'

Example response:

{
  "data": {
    "token": {
      "address": "So11111111111111111111111111111111111111112",
      "name": "Wrapped SOL",
      "symbol": "SOL",
      "priceUsd": 172.43
    },
    "alphaScore": 74,
    "riskRewardRatio": "8.2:1",
    "smartMoneySignals": [
      "Accumulation detected from 3 tracked wallets",
      "Net positive flow over last 6h"
    ],
    "pumpProbability24h": 61,
    "projectedROI": { "low": "12%", "high": "34%", "timeframe": "24-72h" },
    "rugRisk": { "score": 1, "level": "Very Low", "factors": [] },
    "summary": "Strong fundamentals with elevated buy-side pressure. Short-term momentum building.",
    "timestamp": "2026-04-01T14:22:00Z"
  }
}

For paid queries with full data depth, see the API reference.


Building on MPP32

Anyone can list a service in the MPP32 ecosystem. If you have a data API — token scanners, sentiment feeds, wallet scoring, NFT analytics — register it at mpp32.org/build and start monetizing immediately.

  • Zero infrastructure changes — MPP32 wraps your existing endpoint
  • You set the price per query in pathUSD
  • Payments route directly to your Solana wallet
  • Your service gets listed in the public ecosystem directory

Tech stack

Frontend

  • React 18 + Vite
  • TypeScript
  • Tailwind CSS + shadcn/ui
  • Framer Motion
  • TanStack Query (React Query)

Backend

  • Hono on Bun
  • Prisma ORM
  • Zod schema validation
  • mppx — Machine Payments Protocol middleware

Data sources


Running locally

Prerequisites

Steps

# Clone the repo
git clone https://github.com/MPP32/MPP32.git
cd MPP32

# Backend
cd backend
bun install
cp .env.example .env
bun run dev        # starts on http://localhost:3000

# Frontend (new terminal)
cd webapp
bun install
bun run dev        # starts on http://localhost:8000

Open http://localhost:8000 in your browser.

All required environment variables are documented in .env.example.


Project structure

MPP32/
├── webapp/                 # React frontend (Vite + Tailwind)
│   └── src/
│       ├── pages/          # Route-level page components
│       ├── components/     # Shared UI components
│       ├── hooks/          # Custom React hooks
│       └── lib/            # Utilities, API client
│
├── backend/                # Hono API server (Bun runtime)
│   └── src/
│       ├── routes/         # API route handlers
│       ├── types.ts        # Shared Zod schemas — single source of truth
│       └── index.ts        # App entry + middleware
│
└── docs/                   # Extended documentation
    ├── API.md
    ├── ARCHITECTURE.md
    ├── QUICKSTART.md
    └── ROADMAP.md

Documentation

  • API Reference — Endpoints, request/response shapes, authentication, error codes
  • Architecture — How the oracle works, data pipeline, scoring model overview
  • Quickstart — From zero to first query in five minutes
  • Roadmap — What's shipping next and what's planned through end of 2026

Contributing

Bug reports, feature requests, and PRs are welcome. See CONTRIBUTING.md for how to get involved.


License

MIT — see LICENSE.


Built by the MPP32 team  ·  @MPP32_dev on X  ·  mpp32.org

Popular repositories Loading

  1. MPP32 MPP32 Public

    Build your own MPP payments + MPP32 solana intel API

    TypeScript