EN flag

Introduction to Webhooks

Psyll webhooks are your automated trading assistant. Discover how a simple URL can help you integrate any application or script and transmit real-time signals to automate your stock market operations.

Partner image

Webhook

Automate trades and trigger actions by connecting external alerts through fully customizable webhooks.

Webhooks on the Psyll platform are an advanced and highly effective tool that enables trade automation through direct integration of external systems, applications, and scripts. Thanks to webhooks, you can send real-time trading signals directly to your exchange account, which allows for automatic opening, closing, or modifying of positions in line with your strategies, without the need for manual login and order placement.

A webhook is a unique URL (endpoint) to which HTTP POST requests are sent, containing data about specific trading actions, such as buying, selling, setting a limit order, or cancelling an order. Upon receiving a request, the Psyll platform verifies and processes the data, and then executes the appropriate commands on the selected exchange using the API keys assigned to your account.

Due to compatibility with popular tools like TradingView, you can easily link alerts to order generation. Simply provide the webhook URL and the request body in the alert settings for your TradingView strategy to automatically trigger operations in Psyll.

You can find your webhooks under Trading Account > My Webhooks.

1/2
2/2

Webhook operation flow

Webhook Operation Flow

The operation of a webhook on the Psyll platform can be divided into four logical stages that together form a complete transaction automation process. Each of these stages plays a key role in ensuring smooth and secure communication between your system and the exchange.

  • Creating a webhook - In the Psyll panel, you create a new webhook, giving it a unique name, selecting the exchange, and linking it with the appropriate API keys. Each webhook Has a unique code and URL which are used to send signals.
  • Sending requests - From your system, script, or external platform (e.g., TradingView, your own bot), you send HTTP POST requests to the webhook's address, including transaction details such as the type of action, instrument symbol, and quantity.
  • Order execution - Psyll processes the received request, performs the corresponding operation on the exchange, and returns a JSON response confirming the order status, execution details, and information on limit usage.
  • Monitoring and reporting - All requests and responses are logged in the user panel, which allows you to review the history of operations, analyze the effectiveness of the automation, check the usage of available limits, and review exchange responses.

The process begins in the user panel, where you create a new webhook, giving it a unique name, selecting the exchange, and associating it with the appropriate API keys. After saving the configuration, the webhook receives a unique identifier, a unique URL, and an access code, which serve as the entry point to the system. This data should be stored in a safe place, as it enables the direct sending of signals to your account.

The next stage is sending requests. This can be done from your own script, application, external platform, or analytical tool, such as TradingView. HTTP POST requests are sent to the webhook's unique address and contain transaction details in the body, such as the type of action, instrument symbol, and quantity. This lets Psyll know what kind of order should be executed, on which market, and on what scale.

Upon receiving the signal, the Psyll system verifies the data and authorizes the request. It then checks if the appropriate limits are available under your subscription plan, and if so, it forwards the order to the selected exchange via the linked API. In response, Psyll returns data in JSON format, containing information about the operation status, execution time, order parameters, execution details, and the current state of limit usage.

The final element is monitoring and reporting. All sent requests and received responses are saved in the logs available in the Psyll panel. This allows for reviewing the history of operations, analyzing the effectiveness of the automation, monitoring limits, and checking raw exchange responses, which is especially useful for diagnosing potential issues. As a result, the entire process is transparent and fully documented, allowing for effective integration management and quick response when needed.

Webhook Requests

Webhooks on the Psyll platform operate based on HTTP POST requests sent to a unique URL. Each request must contain correctly formatted data that precisely specifies what action the system should perform on the exchange.

Sample URL:

https://psyll.com/env/webhook/{WEBHOOK-ID}

POST data:

code: "{WEBHOOK-CODE}",
action: "BUY",
quantity: 0.01,
symbol: "BTCUSDT"
  • code - Your individual webhook code.
  • action - The type of action you wish to perform.
  • symbol - The stock or currency pair ticker, e.g., "BTCUSDT", "ETHBTC". It's important that the symbol matches the format of the exchange where you are executing the order.
  • quantity - The number of asset units you want to buy or sell.

More details on how to build webhook requests can be found in the "Creating a webhook request" documentation.

Server response

After processing a request, the Psyll server returns a response in JSON format, which contains all relevant information regarding the executed order and its status.

An example response might look like this:

"created": "2025-08-12 18:12:35",
"limit": {
    "account": "PRO",
    "max_per_day": 100,
    "usage": 56
},
"message": "Order executed",
"request": {
    "action": "SET",
    "code": "{WEBHOOK-CODE}",
    "quantity": " 0.01",
    "symbol": "BTCUSDT"
},
"status": "success",
"response": {
    //Exchange response
}

The response includes, among other things:

  • The date and time the request was created,
  • Information about limits and their usage
  • A message confirming the operation was executed,
  • The data submitted in the request (this helps to verify the correctness of the information sent),
  • The status of the operation's execution,
  • The exchange's response containing order details (e.g., order ID, prices, volumes).

This mechanism allows you to easily monitor the effectiveness of your signals and have full control over automated trading.

For more details on the webhook response, please refer to the "Webhook response" documentation.

Subscription plans and limits

Access to webhooks, as well as the number of possible requests and active endpoints, depends on your subscription plan:

  • Free account - 1 active webhook, a maximum of 10 requests per day,
  • PRO account - up to 15 active webhooks and 100 requests per day (each webhook has an individual limit),
  • Business account - an unlimited number of webhooks and requests per day.

You can find out more about the limits in the "Limits" documentation.

TradingView integration

Webhooks in Psyll can be easily connected with alerts in TradingView, which allows you to automatically execute orders on the exchange based on signals generated by your strategies or indicators. Thanks to this, you do not have to manually react to every signal - operations are performed immediately after specific conditions are met in TradingView.

Psyll enables full integration of webhooks with the TradingView alert system, allowing users to combine their investment strategies with the immediate execution of orders on the exchange. TradingView is one of the most popular tools for technical analysis and creating custom strategies, and connecting it with Psyll allows you to fully automate the process of making decisions and executing transactions.

After a unique webhook address is generated in the Psyll panel, it can be used in the TradingView alert configuration as the destination for sending signals. When a strategy or indicator in TradingView generates a buy, sell, or other action signal, it will be automatically sent to Psyll as an HTTP request. Psyll receives this data, processes it, and immediately transmits the appropriate instructions to the user's exchange account, using the previously assigned API keys.

The entire process takes place in real time - from the moment a signal appears in TradingView to the execution of the order on the exchange, it usually takes fractions of a second. This makes the integration an ideal solution for traders who want to react to market changes immediately, eliminating delays resulting from manual order placement.

Example application codes

Examples of using webhooks in various programming languages (including Bash, JavaScript, Python, PHP) are available in our documentation "Usage examples for various programming languages"

There you will find ready-made code snippets that you can copy and immediately use in your application to send requests to Psyll webhooks.

GitHub

Official repositories, libraries and support materials can be found on our GitHub: https://github.com/psyll