{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Designing your transaction fee model","description":"Welcome to the Upvest API documentation. Here you will find all the information you need to integrate with our API.","siteUrl":"https://docs.upvest.co/","image":"/assets/upvest-logo-card.ee25ccc59849324b0b73151a5c972c87639419556344db0b6dcf518151cb4c3c.925ff8b2.png","keywords":"documentation, api","lang":"en-US","meta":[{"name":"description","content":"Welcome to the Upvest API documentation. Here you will find all the information you need to integrate with our API."},{"name":"image","content":"/assets/upvest-logo-card.ee25ccc59849324b0b73151a5c972c87639419556344db0b6dcf518151cb4c3c.925ff8b2.png"},{"name":"twitter:card","content":"summary_large_image"},{"name":"twitter:title","content":"Welcome to the Upvest API Documentation"},{"name":"twitter:image","content":"/assets/upvest-logo-card.ee25ccc59849324b0b73151a5c972c87639419556344db0b6dcf518151cb4c3c.925ff8b2.png"},{"name":"twitter:description","content":"Welcome to the Upvest API documentation. Here you will find all the information you need to integrate with our API."},{"name":"og:url","content":"https://docs.upvest.co/"},{"name":"og:title","content":"Welcome to the Upvest API Documentation"},{"name":"og:description","content":"Welcome to the Upvest API documentation. Here you will find all the information you need to integrate with our API."},{"name":"og:image","content":"/assets/upvest-logo-card.ee25ccc59849324b0b73151a5c972c87639419556344db0b6dcf518151cb4c3c.925ff8b2.png"}],"llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"designing-your-transaction-fee-model","__idx":0},"children":["Designing your transaction fee model"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Transaction fee models allow you to define a set list of fees where the fee amount varies depending on the value of the order. This is useful if you want to apply lower per-trade fees for higher-value orders, or vice versa."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["With transaction fee models, you can setup the following fee structures:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"absolute-fees","__idx":1},"children":["Absolute fees"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Applies a simple absolute  fee per transaction. You can create a flat or tiered absolute fee structure."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Examples:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"flat-fee-model","__idx":2},"children":["Flat fee model:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Simple adds a set fee, for example 1 EUR, per each order."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"tiered-absolute-fee","__idx":3},"children":["Tiered absolute fee:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Tier"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Thresholds (e.g., the order’s cash amount)"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Transaction fee"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["0"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Up to €499.99"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["€1.00"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["1"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["€500.00 – €1,999.99"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["€2.00"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["2"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["€2,000.00 – €9,999.99"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["€5.00"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["3"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["€10,000 and above"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["€10.00"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"relative-fees","__idx":4},"children":["Relative fees"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Charges a percentage of the transaction's monetary value. This scales the fee directly with the size of the transaction, ensuring that the fee is proportionate to the financial exposure or benefit. For instance, a fee of 1% of the trade value."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The value of the transaction fee is set as basis points (bps) and the transaction fee model allows you to set minimum and maximum amounts for each tier if necessary."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"flat-relative-fee-without-minimum-or-maximum-specified","__idx":5},"children":["Flat relative fee without minimum or maximum specified"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Applies a simple flat fee percentage regardless of the order value."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"flat-relative-fee-with-minimum-and-maximum-specified","__idx":6},"children":["Flat relative fee with minimum and maximum specified"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Applies a flat fee percentage with minimum and maximum fee amount."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example: 1 % fee per order, not less than 1 EUR, not more than 100 EUR."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"tiered-relative-fee-models","__idx":7},"children":["Tiered relative fee models"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can define a tiered fee model with the percentage applying to the whole order volume or only to the part of the order that exceeds the tier threshold:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"application-to-the-marginal-increase-on-top-of-the-tier-threshold","__idx":8},"children":["Application to the marginal increase on top of the tier threshold:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Depending on the order volume, each next EUR is charged less fee than the previous."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Tier"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Thresholds (e.g., the order’s cash amount)"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Fee basis point (bps)"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["0"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["First €5000.00 of the order volume"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["300"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["1"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Amount exceeding €5000.00, but less than €10000.00"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["250"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["2"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Amount exceeding € 10.000.00"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["200"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the end user’s order amount is €7000.00, the total fee amount will be calculated as:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["(€5000*3%) + (€2000*2.5%) =  € 200"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"application-to-the-whole-order-amount","__idx":9},"children":["Application to the whole order amount"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Tier"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Thresholds (e.g., the total order’s cash amount)"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Fee basis point (bps)"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Fee limits"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["0"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Up to €4999.99"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["300"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Min: 1 ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["1"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["€5000.00 – €9.999,99"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["250"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Min: 150"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["2"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["10.000.00 and above"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["200"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Min: 250 ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Max: 300"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the user’s order amount is  €7000.00, the total fee amount will be calculated as:",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["max(€7000*2.5%,150) =  €175"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Important"]},": If you’re defining a percentage on the total order volume, the minimum fee amount in the next tier shouldn’t be lower than the maximum fee amount in the previous tier."]}]},"headings":[{"value":"Designing your transaction fee model","id":"designing-your-transaction-fee-model","depth":1},{"value":"Absolute fees","id":"absolute-fees","depth":2},{"value":"Flat fee model:","id":"flat-fee-model","depth":3},{"value":"Tiered absolute fee:","id":"tiered-absolute-fee","depth":3},{"value":"Relative fees","id":"relative-fees","depth":2},{"value":"Flat relative fee without minimum or maximum specified","id":"flat-relative-fee-without-minimum-or-maximum-specified","depth":3},{"value":"Flat relative fee with minimum and maximum specified","id":"flat-relative-fee-with-minimum-and-maximum-specified","depth":3},{"value":"Tiered relative fee models","id":"tiered-relative-fee-models","depth":3},{"value":"Application to the marginal increase on top of the tier threshold:","id":"application-to-the-marginal-increase-on-top-of-the-tier-threshold","depth":4},{"value":"Application to the whole order amount","id":"application-to-the-whole-order-amount","depth":4}],"frontmatter":{"seo":{"title":"Designing your transaction fee model"}},"lastModified":"2026-04-13T15:22:15.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/tol/guides/fees/fees_transaction_fees_designing","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}