We use cookies

We use cookies for authentication, analytics, and personalised advertising. You can choose which categories to allow. Privacy Policy

← Back to Alpha Pipeline
v1.0REST + Webhooks

Alpha Pipeline API

Integrate Alpha Pipeline's regulatory intelligence signals directly into your trading systems, bots, or dashboards via webhooks and REST endpoints.

Real-time signal delivery
API key authentication
Webhook push delivery
Base URLhttps://alphapipeline.ai/api/v1

Webhook Delivery

Register a webhook URL to receive real-time signal notifications via HTTP POST. Alpha Pipeline sends a JSON payload to your endpoint within seconds of a signal being generated.

POST/api/v1/webhooks/register

Register a new webhook endpoint to receive signal notifications.

Request Body

json
{
  "url": "https://your-server.com/webhook/signals",
  "name": "My Trading Bot",
  "minMateriality": 7,
  "tickers": ["AAPL", "TSLA"],   // optional: filter by ticker
  "sentiments": ["BULLISH"],      // optional: BULLISH | BEARISH | NEUTRAL
  "secret": "your-signing-secret" // optional: for HMAC verification
}

Response

json
{
  "success": true,
  "apiKey": "apk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "webhookId": 42
}

Save your API key. It is shown only once and cannot be retrieved again. Use it in the X-API-Key header for all subsequent requests.

Webhook Payload

When a signal fires, Alpha Pipeline sends a POST request to your registered URL with the following payload:

json
{
  "event": "signal.fired",
  "timestamp": "2025-05-04T14:32:10.000Z",
  "signal": {
    "id": 18472,
    "ticker": "AAPL",
    "sentiment": "BULLISH",
    "materialityScore": 8.4,
    "confidenceLevel": 82,
    "source": "SEC_8K",
    "headline": "Apple files 8-K: Major supply chain restructuring",
    "aiThesis": "Supply chain diversification reduces geopolitical risk...",
    "eventDate": "2025-05-04T14:30:00.000Z",
    "dispatchedAt": "2025-05-04T14:32:10.000Z"
  }
}

Verifying Webhook Signatures

If you provided a secret during registration, each request includes an X-Signature-256 header. Verify it as follows:

javascript
const crypto = require('crypto');

function verifySignature(payload, signature, secret) {
  const expected = 'sha256=' + crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(expected),
    Buffer.from(signature)
  );
}

Need help with your integration?

Check the community forum or reach out via the feedback portal.

Community ForumSubmit Feedback

Please read and accept the disclaimer before using Alpha Pipeline.

Important Disclaimer & Terms of Use

Please read carefully before using Alpha Pipeline. You must agree to continue.

1. Not Financial Advice

Alpha Pipeline is an informational and research tool only. All signals, alerts, theses, trade ideas, and analysis generated by this platform are for educational and informational purposes only. Nothing on this platform constitutes financial advice, investment advice, trading advice, or any other type of advice. You should not make any financial decision based solely on information provided here.

2. No Guarantee of Accuracy

The signals, scores, and theses generated by Alpha Pipeline are derived from publicly available government data sources (SAM.gov, SEC EDGAR, ClinicalTrials.gov, etc.) and processed through automated AI models. While we strive for accuracy, we make no representations or warranties of any kind, express or implied, about the completeness, accuracy, reliability, suitability, or availability of any information provided by this platform.

3. Past Performance

The Track Record shown on this platform reflects paper trades only — simulated positions executed at historical prices for demonstration purposes. Past performance of paper trades does not guarantee or predict future results. Real trading involves significant risk of loss, including the possible loss of all capital invested.

4. Risk Disclosure

Trading stocks, options, futures, and other financial instruments involves substantial risk of loss and is not appropriate for all investors. You should carefully consider your investment objectives, level of experience, and risk appetite before making any investment decisions. You may lose some or all of your invested capital. Do not invest money you cannot afford to lose.

5. Independent Verification

Always independently verify any information, signal, or thesis before acting on it. Consult a licensed financial advisor, broker, or investment professional before making any investment decision. Alpha Pipeline does not hold any securities license and is not a registered investment advisor.

6. Limitation of Liability

To the maximum extent permitted by applicable law, Alpha Pipeline and its operators shall not be liable for any direct, indirect, incidental, special, consequential, or punitive damages arising from your use of, or inability to use, this platform or any information provided herein, including but not limited to trading losses.

7. Data Sources

Alpha Pipeline aggregates publicly available data from U.S. government databases including SAM.gov, SEC EDGAR, ClinicalTrials.gov, USPTO, USDA, State Department, and others. This data is subject to change and may contain errors. We are not affiliated with any government agency.

8. Privacy Policy

By using this platform, you also agree to our Privacy Policy, which describes how we collect, use, and protect your personal data in compliance with applicable privacy laws including GDPR and CCPA.

9. Acceptance of Terms

By clicking "I Agree" below, you acknowledge that you have read, understood, and agree to be bound by these terms. You confirm that you are accessing this platform for informational purposes only and will not hold Alpha Pipeline liable for any trading decisions you make.

Last updated: March 2026 · Version 1.0