Portfolio Logic¶
Both the Platform and the REST API apply a validation layer to every portfolio during upload, manual entry, and API calls.
Validation Rules¶
| Condition | Details |
|---|---|
| No cash securities and no NLV | A portfolio containing only margin securities cannot be created unless an explicit Net Liquidation Value (NLV) is provided |
| Negative net liquidation value | The portfolio NLV cannot be negative |
| More than 250 securities | Portfolios are limited to 250 positions |
| Date in the future | The portfolio date cannot be set in the future |
| Date older than one year | The portfolio date cannot be more than one year before today |
Security Classification¶
Every position in a portfolio is classified as either a cash or a margin security. This classification determines whether a portfolio can be created without an explicit NLV.
Margin Securities (*)¶
| Instrument |
|---|
| Short fixed income — Corporate bonds, Government bonds, Convertibles, Exchangeables, Term debt |
| Futures |
| Short options |
| Short equities |
| Swaps — Credit Default Swaps (CDS) and Interest Rate Swaps (IRS) |
Cash Securities (**)¶
| Instrument |
|---|
| Long fixed income — Corporate bonds, Government bonds, Convertibles, Exchangeables, Term debt |
| Long equities |
| Long options — FX, futures, index, equity |
Examples¶
Portfolio without cash securities¶
A portfolio containing only margin securities — one short equity and one Credit Default Swap — with no NLV provided. Both securities validate successfully (green status), but the portfolio cannot be created without at least one cash security or an explicit NLV:
Portfolio with a cash security¶
Adding a long equity position (a cash security) resolves the restriction. Everysk calculates the NLV automatically from the cash positions. The portfolio can now be created:
Margin-only portfolio with a manual NLV¶
When all positions are margin-type, enter an explicit value in the NLV field at the top of the form. This unlocks portfolio creation without requiring a cash security:
