The Trinity Beast — Associate Partner Onboarding Guide

1. Overview — What Is Webhook Push?

The Trinity Beast Webhook Push is a real-time price delivery service. Instead of polling our API for prices (pull model), we push prices directly to your endpoint on a schedule you choose (push model). You tell us which assets you want, where to send them, and how often — we handle the rest.

Prices are sourced from 6 live exchange WebSocket feeds (Coinbase, Gemini, Kraken, Gate.io, Bybit, OKX) and delivered via two protocols:

You can choose UDP only, HTTPS only, or both. Every delivery includes a sequence number for ordering and gap detection.

2. Tiers & Pricing

All prices are monthly. All numbers are multiples of 3 — a core convention of The Trinity Beast.

3. Onboarding — Step by Step

4. Configure Your Endpoints

After receiving your API key, call the configure endpoint to register where prices should be delivered.

Request

POST https://api.cpmp-site.org/webhook/configure
X-Api-Key: YOUR_API_KEY
Content-Type: application/json

{
  "delivery_method": "both",
  "udp_host": "203.0.113.50",
  "udp_port": 9100,
  "https_url": "https://your-app.example.com/webhook/prices",
  "assets": ["BTC", "ETH", "SOL", "XRP", "DOGE", "LINK", "DOT", "AVAX", "UNI"]
}

Parameters

Response

{
  "status": "✅ [LPO] [us-east-2] [BeastMain] [/webhook/configure] [200]",
  "data": {
    "message": "Webhook endpoints configured. Send your verification token to POST /webhook/verify to activate delivery.",
    "subscription_id": "a1b2c3d4-...",
    "delivery_method": "both",
    "udp_host": "203.0.113.50",
    "udp_port": 9100,
    "https_url": "https://your-app.example.com/webhook/prices",
    "selected_assets": ["BTC", "ETH", "SOL", "XRP", "DOGE", "LINK", "DOT", "AVAX", "UNI"],
    "status": "pending_verification",
    "verification_token": "a8f3e2b1c4d5...",
    "interval_seconds": 60,
    "max_assets": 9
  }
}

5. Verify Your Endpoint

Echo back the verification token to prove you control the endpoint. Once verified, delivery begins automatically.

Request

POST https://api.cpmp-site.org/webhook/verify
X-Api-Key: YOUR_API_KEY
Content-Type: application/json

{
  "verification_token": "a8f3e2b1c4d5..."
}

Response (Success)

{
  "status": "✅ [LPO] [us-east-2] [BeastMain] [/webhook/verify] [200]",
  "data": {
    "message": "Endpoint verified. Webhook delivery is now active.",
    "subscription_id": "a1b2c3d4-...",
    "status": "active",
    "delivery_starts": "Prices will begin arriving at your configured interval."
  }
}

6. Payload Format

Every delivery — both UDP and HTTPS — sends the same JSON payload. The payload includes metadata for ordering, deduplication, and source identification.

Sample Payload

{
  "status": "✅ [Webhook] [us-east-2] [BeastWebhook]",
  "subscription_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "delivery_id": "a1b2c3d4-1714780800000-42",
  "sequence": 42,
  "timestamp": "2026-05-03T22:00:00Z",
  "asset_count": 9,
  "region": "us-east-2",
  "cluster_node": "BeastWebhook",
  "tier": "webhook_starter",
  "prices": [
    { "asset": "BTC",  "price": 79307.95,  "source": "coinbase-ws", "updated_at": "2026-05-03T21:59:59Z" },
    { "asset": "ETH",  "price": 2348.29,   "source": "coinbase-ws", "updated_at": "2026-05-03T21:59:58Z" },
    { "asset": "SOL",  "price": 84.80,     "source": "coinbase-ws", "updated_at": "2026-05-03T21:59:59Z" },
    { "asset": "XRP",  "price": 1.3996,    "source": "coinbase-ws", "updated_at": "2026-05-03T21:59:57Z" },
    { "asset": "DOGE", "price": 0.10948,   "source": "coinbase-ws", "updated_at": "2026-05-03T21:59:58Z" },
    { "asset": "LINK", "price": 9.209,     "source": "coinbase-ws", "updated_at": "2026-05-03T21:59:56Z" },
    { "asset": "DOT",  "price": 1.221,     "source": "coinbase-ws", "updated_at": "2026-05-03T21:59:55Z" },
    { "asset": "AVAX", "price": 9.19,      "source": "coinbase-ws", "updated_at": "2026-05-03T21:59:59Z" },
    { "asset": "UNI",  "price": 3.267,     "source": "coinbase-ws", "updated_at": "2026-05-03T21:59:58Z" }
  ]
}

Field Reference

7. Managing Your Subscription

Check Status

GET https://api.cpmp-site.org/webhook/status
X-Api-Key: YOUR_API_KEY

Returns your subscription status, delivery stats, current configuration, tier limits, and monthly push count.

Update Assets

PUT https://api.cpmp-site.org/webhook/assets
X-Api-Key: YOUR_API_KEY
Content-Type: application/json

{
  "assets": ["BTC", "ETH", "SOL", "AVAX", "DOT"]
}

Add or remove assets within your tier's limit. No re-verification needed — changes take effect on the next delivery cycle.

Reconfigure Endpoints

Call POST /webhook/configure again with new endpoint details. This generates a new verification token — you must re-verify before delivery resumes at the new endpoint.

8. Security — HMAC Signature Verification

Every HTTPS delivery includes an X-Webhook-Signature header containing an HMAC-SHA256 signature of the payload body, signed with your webhook secret (provided during configuration). Use this to verify that deliveries are genuinely from The Trinity Beast.

Verification Example (Python)

import hmac, hashlib

def verify_signature(payload_body, signature_header, webhook_secret):
    expected = hmac.new(
        webhook_secret.encode(),
        payload_body,
        hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(expected, signature_header)

Verification Example (Node.js)

const crypto = require('crypto');

function verifySignature(payloadBody, signatureHeader, webhookSecret) {
  const expected = crypto
    .createHmac('sha256', webhookSecret)
    .update(payloadBody)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(expected),
    Buffer.from(signatureHeader)
  );
}

9. FAQ

What happens if my endpoint is down?

UDP: Datagrams are fire-and-forget. If your endpoint is down, the delivery is lost. Use the sequence field to detect gaps. HTTPS: Failed deliveries are retried 3 times with exponential backoff (1s, 3s, 9s). If all retries fail, the delivery is logged and skipped.

Can I change my tier?

Yes. Tier changes are handled through Stripe. When your subscription updates, the delivery engine automatically adjusts your interval and asset limit.

What assets are available?

150 prewarmed assets across 6 exchanges. Enterprise tier Associates can request all 150. Use GET /exchanges to see the full list of available assets and their exchange sources.

What if I exceed my monthly push limit?

Delivery pauses until the next billing cycle. You can upgrade your tier at any time to increase your limit.

Is there a test/sandbox mode?

Not currently. We recommend starting with the Starter tier ($30/month) to validate your integration before upgrading.

Where does my subscription revenue go?

100% of revenue funds freedom from brick kiln debt bondage in Pakistan through Cross Power Ministries of Pakistan (CPMP). When you subscribe, you are funding the mission.

10. API Reference

All endpoints use https://api.cpmp-site.org as the base URL. Authentication is via the X-Api-Key header.