{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml","oas-openapi/api.yaml":"oas-openapi/api.yaml"},"props":{"metadata":{"markdoc":{"tagList":["openapi-code-sample","json-schema"]},"type":"markdown"},"seo":{"title":"6. Place an Order","description":"Fondo is the ground breaking open finance platform that lets you focus on what matters","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":["openapi"],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"6-place-an-order","__idx":0},"children":["6. Place an Order"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["With an active account, you can place fund orders. First, find a fund to invest in."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"browse-available-instruments","__idx":1},"children":["Browse available instruments"]},{"$$mdtype":"Tag","name":"OpenApiCodeSample","attributes":{"descriptionFile":"oas-openapi/api.yaml","operationId":"getClientInstrumentUniverse","parameters":{},"environments":{}},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This returns the instruments available for your client, including ISIN codes, pricing, tradability flags, and minimum investment amounts."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-a-subscription-buy-order","__idx":2},"children":["Create a subscription (buy) order"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A subscription order purchases fund units for a specified amount. The account must have sufficient cash balance (from a deposit) to cover the order."]},{"$$mdtype":"Tag","name":"OpenApiCodeSample","attributes":{"descriptionFile":"oas-openapi/api.yaml","operationId":"createOrder","parameters":{},"environments":{}},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The order is created with status ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["received"]}," and progresses through: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["received"]}," → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pending"]}," → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sent"]}," → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["settled"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"order-request-schema","__idx":3},"children":["Order request schema"]},{"$$mdtype":"Tag","name":"JsonSchema","attributes":{"schema":{"$ref":"../../../openapi/models/order/order_subscription.yaml"},"options":{},"schemaResolved":{"openapi":"3.1.0","components":{"schemas":{"__root":{"$ref":"#/components/schemas/order_subscription"},"uuid":{"$id":"/models/uuid.yaml","title":"UUID","type":"string","example":"49ad7378-121c-4a53-9894-dfd14a7b4877","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"},"executor_ref":{"$id":"/models/common/executor_ref.yaml","type":"string","title":"executor reference","description":"SSN of the individual executing the operation. On write operations, validated against the account owner's SSN — requests with a mismatched value are rejected.\n\nThe partner is responsible for verifying the executor's identity (e.g. via BankID) before including this value.\n","example":"197001010003"},"order_subscription":{"$id":"/models/order/order_subscription.yaml","type":"object","description":"subscription order","title":"subscription order","required":["account","instrument","orderType","amount","executorRef"],"properties":{"orderType":{"const":"subscription"},"account":{"$ref":"#/components/schemas/uuid","description":"Account ID"},"clientRef":{"type":"string","description":"Client applied ref","example":"my_order_123"},"executorRef":{"$ref":"#/components/schemas/executor_ref"},"instrument":{"type":"string","example":"US64110L1061USD","description":"Fondo instrument ID"},"amount":{"type":"number","example":100,"description":"The amount to subscribe for.\n"}}}}}},"schemaResolvedErrors":[]},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"validate-before-submitting","__idx":4},"children":["Validate before submitting"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["?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."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response may contain an array of validation errors describing what failed."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next:"]}," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/api-guide/getting-started/withdrawals"},"children":["Withdrawals"]}]}]},"headings":[{"value":"6. Place an Order","id":"6-place-an-order","depth":1},{"value":"Browse available instruments","id":"browse-available-instruments","depth":2},{"value":"Create a subscription (buy) order","id":"create-a-subscription-buy-order","depth":2},{"value":"Order request schema","id":"order-request-schema","depth":3},{"value":"Validate before submitting","id":"validate-before-submitting","depth":2}],"frontmatter":{"seo":{"title":"6. Place an Order"}},"lastModified":"2026-04-14T12:45:03.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/api-guide/getting-started/place-order","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}