To integrate with Upvest, clients will use two environments: Sandbox for testing and Live for production. This section explains the differences between the two environments and highlights each environment’s unique behaviors.
Understanding these concepts can help you leverage the two environments to prepare and deploy changes to your implementation.
The Sandbox environment is a safe playground where you can build, experiment, and test flows without any financial or regulatory impact. For example, you can use Sandbox to validate tenant and client configurations, such as scopes and permissions, to ensure they align with integration plans and meet business needs.
The Live environment is a real-time area that supports live trading with real money movements and is where onboarding and trading are fully regulated and legally binding.
Note: In Sandbox, there is a rate limiting threshold of 300 requests per second (RPS). No such limits exist on Live/Production.
The following table provides a quick comparison between the Sandbox and Live environments. For more detailed information, refer to the following sections.
| Functionalty | Sandbox | Live |
|---|---|---|
| User onboarding & account set-up | ||
| Anti-Money Laundry (AML) checks | Disabled | Enabled |
| Politically Exposed Person (PEP) | Disabled | Enabled |
| User Onboarding and Creating Account Groups | Manual Process | Monitored by Upvest |
| Orders and trades | ||
| Order Executions | Instantly settled Special behaviors for some ISINs | Executed and settled reflecting real-world trading |
| Order Cancellations | Instantly cancelled as long as the order status allows | Market-based rules and when the order status allows |
| Price data | ||
| Price Data | Simulated | Real-time market feeds |
| Settlements, positions, and payments | ||
| Settlements | Immediately settled | Normal settlement (usually T+1 for BUY and T+2 for SELL orders) |
| Positions | Simulated | Updated based on real-world dynamics |
| Payments | Immediate. Simulated with Test endpoint | Follows market timings |
| Taxes | ||
| Taxes | Simulated (mocked) logic for certain ISINs | Local regulations |
| Treasury | Manually triggered reports with the ability to schedule if needed. | Manually triggered reports |
| Corporate Actions | Manually triggered and can be based on real or sample data. | Triggered by actual events |