Skip to content
Last updated

With an active account, you can place fund orders. First, find a fund to invest in.

Browse available instruments

curl -i -X GET \
  https://api.sandbox.fondo.se/v2/partner/client/49ad7378-121c-4a53-9894-dfd14a7b4877/instrument \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

This returns the instruments available for your client, including ISIN codes, pricing, tradability flags, and minimum investment amounts.

Create a subscription (buy) order

A subscription order purchases fund units for a specified amount. The account must have sufficient cash balance (from a deposit) to cover the order.

curl -i -X POST \
  https://api.sandbox.fondo.se/v2/partner/client/49ad7378-121c-4a53-9894-dfd14a7b4877/order \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "orderType": "order_subscription",
    "account": "49ad7378-121c-4a53-9894-dfd14a7b4877",
    "clientRef": "my_order_123",
    "executorRef": "197001010003",
    "instrument": "US64110L1061USD",
    "amount": 100
  }'

The order is created with status received and progresses through: receivedpendingsentsettled.

Order request schema

orderTypeanyrequired
Value "subscription"
accountstring(UUID)^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...required
Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"
clientRefstring

Client applied ref

Example: "my_order_123"
executorRefstring(executor reference)required

SSN of the individual executing the operation. On write operations, validated against the account owner's SSN — requests with a mismatched value are rejected.

The partner is responsible for verifying the executor's identity (e.g. via BankID) before including this value.

Example: "197001010003"
instrumentstringrequired

Fondo instrument ID

Example: "US64110L1061USD"
amountnumberrequired

The amount to subscribe for.

Example: 100

Validate before submitting

Add ?validate-only to dry-run the order without creating it. The request body is the same — Fondo validates the order and returns errors without creating it.

The response may contain an array of validation errors describing what failed.

Next: Withdrawals