Use a Custom Webhook Source

Copy your strategy webhook URL

In the Nyria app, open your strategy and go to the Integration tab. Copy the webhook URL. It looks like this:

https://trades.nyria.io/webhooks/wh_8f4c2a91b7d34e0fae9c1b6d2e8f0a4c

The path segment after /webhooks/ is your strategy's token hash (tokenHash). It's the only authentication on the request — treat it like a password. There is no separate Authorization header.

Send the minimum-viable payload

The smallest valid body is two fields: ticker and action. Open a terminal and run:

curl -X POST https://trades.nyria.io/webhooks/wh_REPLACE_WITH_YOUR_TOKEN \
  -H "Content-Type: application/json" \
  -d '{
    "ticker": "AAPL",
    "action": "buy"
  }'

Replace wh_REPLACE_WITH_YOUR_TOKEN with the token hash you copied in Step 1. Nyria looks up the strategy by token, matches buy against your entry rule, builds the order using the strategy's position-sizing config, and forwards it to the connected broker.

You should see the alert show up in the strategy's Logs tab within a second or two.

Override sizing for a single alert

The strategy controls position sizing by default. To override it for one alert, add quantity (shares/contracts) or notional (USD):

curl -X POST https://trades.nyria.io/webhooks/wh_REPLACE_WITH_YOUR_TOKEN \
  -H "Content-Type: application/json" \
  -d '{
    "ticker": "AAPL",
    "action": "buy",
    "quantity": 25,
    "order_type": "limit",
    "price": 175.50,
    "duration": "day"
  }'

• quantity — explicit share count for equities, contract count for options.
• notional — dollar-based sizing (useful for crypto; e.g. "notional": 500).
• order_type — market, limit, stop, or stop_limit. Default is market.
• price — required when order_type is anything other than market.
• duration — day, gtc, pre, or post. Default is day.

Send a plain-text body instead of JSON

JSON is the recommended format, but if your source can only emit free-form text (older alerting platforms, some IFTTT/Zapier steps), Nyria's parser also reads plain text:

curl -X POST https://trades.nyria.io/webhooks/wh_REPLACE_WITH_YOUR_TOKEN \
  -H "Content-Type: text/plain" \
  --data-binary "AAPL long entry"

The parser extracts the instrument (AAPL), the direction (long), and the action (entry). Set Content-Type: text/plain so Nyria doesn't try to JSON-decode the body.

Add idempotency for retry-safe sends

If your script retries on network failures (or your provider delivers the same alert twice), Nyria's default behavior protects you: identical payloads received within 60 seconds are deduplicated by hash and only the first one places an order.

If you actually want to scale into the same position — for example, firing the same buy payload twice on purpose — add a unique idempotency_key:

curl -X POST https://trades.nyria.io/webhooks/wh_REPLACE_WITH_YOUR_TOKEN \
  -H "Content-Type: application/json" \
  -d '{
    "ticker": "AAPL",
    "action": "buy",
    "quantity": 10,
    "idempotency_key": "scale-in-2026-06-05-09-31-15"
  }'

Each distinct idempotency_key value is treated as a new alert. Reuse a key and Nyria treats it as a duplicate and skips it.

Recommended formats for the key:

• A monotonically increasing counter your script tracks (scale-in-1, scale-in-2).
• An ISO-8601 timestamp with second precision (2026-06-05T09:31:15Z).
• A UUID v4 minted per alert.

Handle the response

Nyria responds with an HTTP status code and a JSON body. Wire your sender to log or alert on non-2xx responses.

A minimal Python sender that surfaces failures:

import requests

WEBHOOK_URL = "https://trades.nyria.io/webhooks/wh_REPLACE_WITH_YOUR_TOKEN"

def fire_alert(payload: dict) -> None:
    r = requests.post(WEBHOOK_URL, json=payload, timeout=10)
    r.raise_for_status()
    body = r.json()
    if body.get("skipped"):
        print(f"Nyria skipped: {body.get('reason')}")
    else:
        print(f"Nyria accepted: alert id {body.get('alert_id')}")

fire_alert({"ticker": "AAPL", "action": "buy", "quantity": 10})

raise_for_status() turns 4xx/5xx into exceptions so your retry logic can see them. Always use a finite timeout — Nyria responds quickly, but a hung socket can wedge your producer.

Confirm the order in the broker

Open your broker dashboard (or the Nyria app's bot view) and verify the order landed. If you used the curl from Step 2 against a paper account, you should see an AAPL market buy at the strategy's default size.

If the order is not there, check the strategy's Logs tab. Every inbound webhook generates a log entry — accepted, skipped, or rejected — with the reason and any parse output.