Setup · Reference

Payload Guide

Reference for traders bringing their own Pine strategies. Custom strategy payload must match Jimmy's receiver contract before Jimmy can process Paper Mode receipts. Private JimmyDesk strategies do not use this page.

← My Jimmy Alert Setup

Use case

CUSTOM

Use this only for custom strategies

Event

paper_signal

current Jimmy receiver event type

Message

JSON

custom strategy alert message format

Private strategies

FUNCTION CALLS

private JimmyDesk strategies do not use this page

Receiver contract

paper_signal

Use this only for custom strategies. Private JimmyDesk strategies do not use this message payload page. For private strategies, leave the TradingView Message box empty and use Alert Function Calls Only.

{
  "eventType": "paper_signal",
  "ingressSecret": "{{PRIVATE_BETA_PAPER_SIGNAL_SECRET}}",
  "payload": {
    "signalId": "{{strategy.order.id}}-{{timenow}}",
    "strategySlug": "{{jimmydesk_custom_strategy_slug}}",
    "symbol": "{{ticker}}",
    "side": "long",
    "price": {{close}},
    "source": "tradingview",
    "receivedAt": "{{timenow}}"
  }
}

Required fields

receiver payload

eventType	Must be paper_signal for the current receiver.
ingressSecret	Paste the private Paper Mode secret issued by JimmyDesk.
payload.signalId	Unique ID for this alert. Use strategy name plus time/bar index.
payload.strategySlug	Your mapped custom strategy slug after JimmyDesk enables it.
payload.symbol	TradingView ticker or syminfo ticker.
payload.side	side must be long or short.
payload.price	Current/entry price from the strategy, usually close.
payload.source	tradingview or your strategy name.
payload.receivedAt	TradingView timenow/time placeholder if available.

Do not include

keep out

Do not include broker keys, account numbers, private keys, live order flags, execution commands, or TradersPost webhook URLs in a TradingView custom strategy payload.

AI helper prompt

copy/paste

Copy this prompt into your AI assistant with your Pine Script. It tells the assistant to update only the alert message shape and to validate against Jimmy’s receiver contract.

You are helping me adapt my TradingView Pine Script strategy alerts for JimmyDesk.

Goal:
- Keep my existing strategy logic intact.
- Format the TradingView alert message to match the Jimmy receiver contract.
- Do not add broker execution, account credentials, live order flags, or TradersPost webhook URLs.

Jimmy receiver contract:
{
  "eventType": "paper_signal",
  "ingressSecret": "{{PRIVATE_BETA_PAPER_SIGNAL_SECRET}}",
  "payload": {
    "signalId": "{{unique_signal_id}}",
    "strategySlug": "{{jimmydesk_custom_strategy_slug}}",
    "symbol": "{{ticker}}",
    "side": "long",
    "price": {{close}},
    "source": "tradingview",
    "receivedAt": "{{timenow}}"
  }
}

Rules:
1. eventType must be exactly "paper_signal".
2. side must be exactly "long" or "short".
3. signalId must be unique for each alert.
4. Keep ingressSecret as a placeholder so I can paste the JimmyDesk secret myself.
5. Do not include broker keys, account numbers, private keys, live order flags, execution commands, or TradersPost webhook URLs.
6. Return the final TradingView alert message JSON only after validating it matches the Jimmy receiver contract.

Here is my Pine Script strategy:

[PASTE MY PINE SCRIPT HERE]