API Documentation

Integrate our AI trading signals into your applications, trading bots, and platforms

Last Updated:

Developer Access: The UR Trading Expert API allows developers to integrate our AI trading signals into their own applications, trading bots, and platforms. This documentation covers authentication, endpoints, and usage examples.

1. Getting Started

1.1 API Overview

The UR Trading Expert API provides:

1.2 Base URL

All API requests should be made to:

https://api.urtradingexpert.com/v1

1.3 Authentication

All API requests require authentication using an API key. Include your API key in the request header:

Authorization: Bearer YOUR_API_KEY

To obtain an API key:

  1. Log in to your account via the Telegram bot
  2. Navigate to Settings → API Access
  3. Generate a new API key
  4. Store your API key securely (it will only be shown once)

2. Rate Limits

API rate limits vary by subscription tier:

Rate limit headers are included in all responses:

3. Endpoints

3.1 Get Recent Signals

GET /signals

Retrieve recent trading signals.

Query Parameters:

  • asset (optional) - Filter by asset (BTC, ETH, EURUSD, etc.)
  • limit (optional) - Number of signals to return (default: 10, max: 100)
  • offset (optional) - Pagination offset

Example Request:

GET /v1/signals?asset=BTC&limit=20
Authorization: Bearer YOUR_API_KEY

Example Response:

{
  "signals": [
    {
      "id": "sig_123456",
      "asset": "BTC/USDT",
      "direction": "BUY",
      "entry": 67250.00,
      "take_profit": 69500.00,
      "stop_loss": 66100.00,
      "confidence": 87,
      "risk_reward": 2.5,
      "timestamp": "2025-01-15T10:30:00Z",
      "analysis": "Strong bullish momentum..."
    }
  ],
  "total": 150,
  "limit": 20,
  "offset": 0
}

3.2 Get Signal by ID

GET /signals/{signal_id}

Retrieve a specific signal by its ID.

Example Request:

GET /v1/signals/sig_123456
Authorization: Bearer YOUR_API_KEY

3.3 Get Account Information

GET /account

Get information about your account and subscription.

Example Response:

{
  "user_id": "user_123",
  "username": "trader123",
  "subscription_tier": "premium",
  "subscription_status": "active",
  "expires_at": "2025-02-15T00:00:00Z",
  "api_requests_remaining": 850,
  "api_requests_limit": 1000
}

3.4 Create Webhook

POST /webhooks

Create a webhook to receive signal notifications.

Request Body:

{
  "url": "https://your-app.com/webhooks/signals",
  "secret": "your_webhook_secret",
  "events": ["signal.created"],
  "filters": {
    "assets": ["BTC", "ETH"],
    "min_confidence": 75
  }
}

4. Webhooks

4.1 Webhook Events

Available webhook events:

4.2 Webhook Payload

Webhook payloads are sent as POST requests to your configured URL:

{
  "event": "signal.created",
  "timestamp": "2025-01-15T10:30:00Z",
  "data": {
    "id": "sig_123456",
    "asset": "BTC/USDT",
    "direction": "BUY",
    "entry": 67250.00,
    "take_profit": 69500.00,
    "stop_loss": 66100.00,
    "confidence": 87
  }
}

4.3 Webhook Security

Each webhook request includes a signature header for verification:

X-UR-Signature: sha256=abc123...

Verify the signature using your webhook secret to ensure requests are authentic.

5. Error Handling

5.1 Error Response Format

All errors follow this format:

{
  "error": {
    "code": "INVALID_API_KEY",
    "message": "The provided API key is invalid",
    "details": {}
  }
}

5.2 Error Codes

6. Code Examples

6.1 Python Example

import requests

API_KEY = "your_api_key"
BASE_URL = "https://api.urtradingexpert.com/v1"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# Get recent signals
response = requests.get(
    f"{BASE_URL}/signals",
    headers=headers,
    params={"asset": "BTC", "limit": 10}
)

signals = response.json()
print(signals)

6.2 JavaScript Example

const API_KEY = 'your_api_key';
const BASE_URL = 'https://api.urtradingexpert.com/v1';

async function getSignals() {
  const response = await fetch(`${BASE_URL}/signals?asset=BTC&limit=10`, {
    headers: {
      'Authorization': `Bearer ${API_KEY}`,
      'Content-Type': 'application/json'
    }
  });
  
  const signals = await response.json();
  console.log(signals);
}

getSignals();

7. SDKs and Libraries

Official SDKs are available for popular languages:

Check our GitHub for the latest SDKs and examples.

8. Support

For API support and questions:

Note: API access is available for Premium and VIP subscribers. Free trial users have limited API access. For production use, we recommend implementing proper error handling, rate limiting, and webhook signature verification.