money
trades
customer-session

Submit a buy trade

Changed on

Buys an eligible asset using the signed-in member’s current business permissions and financial controls. Amount is in USDC. For a fund, supply the quote’s price_per_unit as quoted_price_per_unit. Immediate execution checks the current NAV; an approval-pending request instead uses a fresh checker quote when approved.

An applicable approval requirement returns outcome=approval_pending and a transfer_approval without booking a movement. Otherwise outcome=created includes the movement and transaction. Requires an Idempotency-Key; duplicates return 409 rather than a cached response. Preserve the original key and reconcile the outcome before another submission.

post/money/trades/buy

Request

  • Base URL
    https://api.stablesea.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.stablesea.com/money/trades/buy
  • Auth
    none declared. Required headers: Idempotency-Key

Headers

Idempotency-Keystring required

Required client idempotency key; a duplicate submission with the same key is rejected with 409.

Request body

amount_usdstring required
funding_source'platform' | 'stellar' | 'solana'
quoted_price_per_unitstring
settlement_preference'standard' | 'instant'
symbolstring required

Response

OK

money_movement_idstring
outcome'created' | 'approval_pending'

Changes

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status