pnl

Retrieve per-risk-factor PnL breakdowns for a numeric node_id on a specified date.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/SpecForgeAI/deepagent-bot --skill pnl-specforgeai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pnl
Source: https://github.com/SpecForgeAI/deepagent-bot/tree/main/skills/pnl
Command: npx skills add https://github.com/SpecForgeAI/deepagent-bot --skill pnl-specforgeai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyzing profits and losses by risk factor for a specific business node is labor-intensive and error-prone. This skill decomposes PnL by risk factors (FX, IR, EQ, etc.), enabling precise attribution and faster decision-making.

Core Features & Use Cases

  • Risk-factor PnL breakdown: Retrieve daily, monthly-to-date (MTD), and year-to-date (YTD) PnL by risk factor for a given node.
  • Input validation & contracts: Enforces numeric node_id only and guides users to resolve text inputs via node_resolver.
  • Structured outputs for downstream workflows: Returns a JSON payload with per-factor PnL, totals, and metadata ready for dashboards or reports.

Quick Start

Ask the system to retrieve the PnL by risk factors for a numeric node_id on a specific date.

Frequently Asked Questions about pnl

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get PnL breakdown by risk factor for a specific business node?▼

You retrieve a PnL breakdown by risk factor by providing a numeric node_id and a valid date. The system returns a structured JSON payload with per-risk-factor PnL, totals, and metadata ready for dashboards.

What is risk factor PnL attribution and when do I need it?▼

Risk factor PnL attribution decomposes profits and losses by underlying factors like FX, IR, and EQ. You need it when precise attribution across business nodes is required for faster, data-driven decision-making.

How do I resolve a node name to a node_id for PnL analysis?▼

If your input includes a non-numeric node name, you must invoke a node_resolver to obtain the corresponding numeric node_id. Once resolved, retry the PnL request using the numeric identifier.

What date formats are valid for requesting daily, MTD, or YTD PnL?▼

Valid date inputs for PnL requests are strictly yesterday, today, or a valid ISO date. Submitting an unrecognized date format will trigger an INVALID_DATE error and prevent the breakdown.

Why am I getting a MISSING_NODE_ID error during PnL attribution?▼

A MISSING_NODE_ID error occurs when the input lacks a numeric node_id. You must provide a valid numeric identifier or resolve a text-based node name to a numeric ID before requesting the PnL breakdown.

Can I use text-based node names instead of numeric IDs for risk analysis?▼

You cannot directly use text-based node names for risk analysis; the system enforces numeric node_id inputs only. You must first resolve any text names to a numeric ID using a node_resolver component.