TaskAI
TaskAI

API & Webhooks (Preview)

Integrate TASKAI into your workflows with webhooks and API access

Overview

Pro tier users can access TASKAI's API and webhook system to integrate alerts and data into their own tools, Discord servers, Notion databases, and more.

Note: API and webhooks are currently in preview. Features and endpoints may change.

Webhooks

Webhooks let you receive real-time alerts at a URL you control.

Creating a Webhook

/webhook create https://your-domain.com/endpoint

You'll receive a webhook ID and secret for verification.

Webhook Events

Available event types:

  • radar.new_pair: New token pair detected
  • radar.graduation: Token graduated from launch platform
  • scan.complete: Safety scan finished
  • pulse.alert: CT-Pulse trend detected

Webhook Payload

Example radar.new_pair payload:

{
  "event": "radar.new_pair",
  "timestamp": "2025-01-15T10:30:00Z",
  "data": {
    "token_address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
    "name": "Example Token",
    "symbol": "EXMPL",
    "liquidity_usd": 125000,
    "dex": "Raydium",
    "pool_address": "..."
  }
}

Verifying Webhooks

Each request includes a signature header:

X-TASKAI-Signature: sha256=<signature>

Verify using your webhook secret (HMAC-SHA256).

Managing Webhooks

/webhook list          # View all webhooks
/webhook delete <id>   # Remove a webhook
/webhook pause <id>    # Temporarily disable
/webhook resume <id>   # Re-enable

REST API

Authentication

Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Generate a key with /api key in Telegram.

Rate Limits

  • Free tier: Not available
  • Holder tier: 100 requests/hour
  • Pro tier: 1000 requests/hour

Base URL

https://api.taskai.xyz/v1

Endpoints

GET /scan/:address

Run a safety scan on a token.

Parameters:

  • address (required): Token mint address

Response:

{
  "token": "7xKXtg2CW...",
  "name": "Example Token",
  "symbol": "EXMPL",
  "mint_authority": null,
  "freeze_authority": null,
  "holder_count": 1250,
  "top_10_concentration": 15.3,
  "risk_score": 3
}

GET /radar/recent

Fetch recent fresh pairs.

Query Parameters:

  • limit (optional): Max results (default: 10, max: 50)
  • min_liquidity (optional): Minimum liquidity in USD

Response:

{
  "pairs": [
    {
      "token_address": "...",
      "name": "...",
      "symbol": "...",
      "liquidity_usd": 50000,
      "created_at": "2025-01-15T10:00:00Z"
    }
  ]
}

GET /pulse/trending

Get trending CT narratives.

Response:

{
  "trends": [
    {
      "hashtag": "#solana",
      "mentions_24h": 15420,
      "sentiment": 0.72,
      "top_accounts": ["@account1", "@account2"]
    }
  ]
}

SDK (Coming Soon)

We're building official SDKs for:

  • TypeScript/Node.js
  • Python
  • Rust

Join our GitHub to track progress and contribute.

Use Cases

Discord Integration

Send radar alerts to your server's trading channel.

Notion Database

Auto-populate a Notion database with scan results.

Trading Bots

Build custom trading strategies with TASKAI data.

Analytics Dashboards

Pull data into Grafana, Dune, or custom dashboards.

Support

For API questions or webhook issues:

  • Email: api@taskai.xyz
  • Discord: #api-support channel
  • Docs: Full API reference coming soon

Roadmap

Planned features:

  • Historical data endpoints (T+60)
  • WebSocket streams (T+90)
  • GraphQL API (T+120)
  • Zapier integration (T+90)