Schwab icon

Schwab

Interact with Schwab Trader API
Join our community

Actions13

Overview

This node interacts with the Schwab Trader API, specifically supporting operations related to "Orders" such as previewing an order. The "Preview Order" operation allows users to simulate or validate an order before submitting it, providing insights into how the order would be processed, including validation results, commissions, fees, and other details.

Common scenarios where this node is beneficial include:

  • Validating complex orders programmatically before execution.
  • Retrieving detailed information about potential order outcomes.
  • Integrating Schwab trading workflows into automated pipelines for risk management or compliance checks.

For example, a user might input an order strategy and receive back validation alerts and commission estimates to decide whether to proceed with placing the order.

Properties

Name Meaning
Account Number The encrypted ID of the account associated with the order. This is required to identify which account the order preview applies to.
Order Id Numeric identifier of the order to preview.
Order Strategy JSON object describing the order's structure, including order balance and legs. This defines the specifics of the order being previewed.
Order Validation Result JSON object containing arrays of alerts, accepts, rejects, reviews, and warnings related to the order validation process. This provides feedback on the order's validity and any issues detected.
Commission And Fee JSON object detailing commission and fee calculations for the order, including commission legs, fee legs, and true commission values.
Additional Headers Optional custom HTTP headers to send with the request. Useful for adding extra metadata or identifiers. Authorization headers are handled automatically by the node.

Output

The node outputs the response from the Schwab Trader API's order preview endpoint in the json field of each output item. The structure typically includes:

  • Validation results (alerts, accepts, rejects, reviews, warns).
  • Commission and fee details.
  • Any additional data returned by the API relevant to the order preview.

If multiple items are returned by the API, each is output as a separate item. The node does not output binary data.

Dependencies

  • Requires an OAuth2 API credential configured for authenticating with the Schwab Trader API.
  • The base URL used is https://api.schwabapi.com/trader/v1.
  • The node automatically sets Accept: application/json and Content-Type: application/json headers.
  • Users can add custom headers if needed via the "Additional Headers" property.

Troubleshooting

  • No routing found error: If the node throws an error about missing routing for the specified resource-operation combination, ensure that the resource is set to "Orders" and operation to "Preview Order" exactly, and that all required parameters are provided.
  • Authentication errors: Failures due to invalid or expired OAuth2 tokens will result in HTTP 401 or 403 errors. Refresh or reconfigure the OAuth2 credentials accordingly.
  • Invalid JSON inputs: The properties orderStrategy, orderValidationResult, and commissionAndFee expect valid JSON strings. Malformed JSON will cause parsing errors. Validate JSON syntax before input.
  • API request failures: Network issues or API downtime may cause request failures. Check network connectivity and Schwab API status.
  • Continue On Fail behavior: If enabled, the node will output error details per item instead of stopping execution on failure.

Links and References

  • Schwab Trader API Documentation (requires login)
  • OAuth2 authentication setup guides in n8n documentation
  • JSON validation tools for preparing input properties

Discussion