> ## Documentation Index > Fetch the complete documentation index at: https://docs.compasslabs.ai/llms.txt > Use this file to discover all available pages before exploring further. # Charge a partner fee > Charge a partner fee on a filled equity sell order's USDC proceeds. Equity orders settle off-chain, so fees can't be bundled into the trade — call this after a sell fills and it builds a USDC transfer of your `fee` from the actual proceeds, executed by the product account (owner signs, or EIP-712 with `gas_sponsorship`). ## OpenAPI ````yaml /v2/combined_spec.json post /v2/tokenized_assets/order/{order_hash}/charge_fee openapi: 3.1.0 info: title: Compass API description: Compass Labs DeFi API version: 0.0.1 servers: - url: https://api.compasslabs.ai description: Production server security: - ApiKeyAuth: [] paths: /v2/tokenized_assets/order/{order_hash}/charge_fee: post: tags: - Tokenized Assets summary: Charge a partner fee description: >- Charge a partner fee on a filled equity sell order's USDC proceeds. Equity orders settle off-chain, so fees can't be bundled into the trade — call this after a sell fills and it builds a USDC transfer of your `fee` from the actual proceeds, executed by the product account (owner signs, or EIP-712 with `gas_sponsorship`). operationId: v2_tokenized_assets_order_{order_hash}_charge_fee parameters: - name: order_hash in: path required: true schema: type: string title: Order Hash requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TokenizedAssetsChargeFeeRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/TokenizedAssetsChargeFeeResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' x-codeSamples: - lang: python label: Python (SDK) source: |- from compass_api_sdk import CompassAPI, models with CompassAPI( api_key_auth="", ) as compass_api: res = compass_api.tokenized_assets.tokenized_assets_order_order_hash_charge_fee(order_hash="", owner="", fee={ "recipient": "", "amount": 8619.46, "denomination": models.TokenizedAssetsFeeDenomination.PERCENTAGE, }, gas_sponsorship=False) # Handle response print(res) - lang: typescript label: Typescript (SDK) source: |- import { CompassApiSDK } from "@compass-labs/api-sdk"; const compassApiSDK = new CompassApiSDK({ apiKeyAuth: "", }); async function run() { const result = await compassApiSDK.tokenizedAssets.tokenizedAssetsOrderOrderHashChargeFee({ orderHash: "", tokenizedAssetsChargeFeeRequest: { owner: "", fee: { recipient: "", amount: 8619.46, denomination: "PERCENTAGE", }, gasSponsorship: false, }, }); console.log(result); } run(); components: schemas: TokenizedAssetsChargeFeeRequest: properties: owner: type: string title: Owner description: The owner's wallet address; the product account is derived from it. fee: $ref: '#/components/schemas/TokenizedAssetsFee' description: >- The partner fee to charge on the sell proceeds, taken in USDC and sent to your fee recipient. gas_sponsorship: type: boolean title: Gas Sponsorship description: >- When true, returns an EIP-712 payload for gas-sponsored execution instead of an unsigned transaction. default: false type: object required: - owner - fee title: TokenizedAssetsChargeFeeRequest description: >- Charge a partner fee on the USDC proceeds of a filled sell order. Equity orders fill off-chain via a third-party venue, so the fee can't ride inside the trade (unlike Midas/earn/credit). After the sell order fills, call this with the order hash to build a USDC `transfer(recipient, fee)` executed by the product account. example: fee: amount: '1' denomination: PERCENTAGE recipient: '0x1111111111111111111111111111111111111111' gas_sponsorship: false owner: '0x29F20a192328eF1aD35e1564aBFf4Be9C5ce5f7B' TokenizedAssetsChargeFeeResponse: properties: transaction: anyOf: - $ref: '#/components/schemas/UnsignedTransaction' - type: 'null' description: Unsigned transaction transferring the fee from the product account. eip_712: anyOf: - $ref: '#/components/schemas/BatchedSafeOperationsResponse-Output' - type: 'null' description: EIP-712 payload for gas-sponsored execution. fee_amount: type: string pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ title: Fee Amount description: Fee charged, in USDC. proceeds: type: string pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ title: Proceeds description: Filled USDC proceeds the fee was computed on. type: object required: - fee_amount - proceeds title: TokenizedAssetsChargeFeeResponse description: |- Unsigned USDC fee transfer for the owner to sign. Exactly one of `transaction` (gas_sponsorship=false) or `eip_712` (gas_sponsorship=true) is set. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError TokenizedAssetsFee: properties: recipient: type: string title: Recipient description: The wallet address that will receive the fee. examples: - '0xb8340945eBc917D2Aa0368a5e4E79C849c461511' amount: anyOf: - type: number exclusiveMinimum: 0 - type: string pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ title: Amount description: >- The fee amount. If `denomination` is 'PERCENTAGE', this is a percentage of the transaction amount (e.g., 1.5 for 1.5%). If `denomination` is 'FIXED', this is a fixed amount in token units (e.g., 0.1 for 0.1 tokens). If `denomination` is 'PERFORMANCE', this is a percentage of realized profit calculated using FIFO cost basis (e.g., 10 for 10% of profit). examples: - 1.5 - 0.1 - 10 denomination: type: string enum: - PERCENTAGE - FIXED title: Denomination description: >- The unit type for the fee amount. Use 'PERCENTAGE' for a percentage-based fee (e.g., 1.5 means 1.5% of the trade proceeds), or 'FIXED' for a fixed token amount (e.g., 0.1 means 0.1 tokens). default: PERCENTAGE examples: - PERCENTAGE - FIXED additionalProperties: false type: object required: - recipient - amount title: TokenizedAssetsFee description: >- Fee configuration for tokenized-asset trades. Same shape as `Fee`, but narrows `denomination` to the values supported by tokenized-asset trades. PERFORMANCE is not supported because realized-profit fees are not computed for spot buy/sell trades. UnsignedTransaction: properties: chainId: type: string title: Chainid description: The chain id of the transaction data: type: string title: Data description: The data of the transaction from: type: string title: From description: The sender of the transaction gas: anyOf: - type: string - type: 'null' title: Gas description: The gas of the transaction to: type: string title: To description: The recipient of the transaction value: type: string title: Value description: The value of the transaction nonce: type: string title: Nonce description: The nonce of the address maxFeePerGas: type: string title: Maxfeepergas description: The max fee per gas of the transaction maxPriorityFeePerGas: type: string title: Maxpriorityfeepergas description: The max priority fee per gas of the transaction type: object required: - chainId - data - from - gas - to - value - nonce - maxFeePerGas - maxPriorityFeePerGas title: UnsignedTransaction example: chainId: '0x2105' data: >- 0x1688f0b900000000000000000000000029fcb43b46531bca003ddc8fcb67ffe91900c762000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000675f4a3d from: '0x4A83b4413CF41C3244027e1590E35a0F48403F0c' gas: '0x7a120' maxFeePerGas: '0x59682f00' maxPriorityFeePerGas: '0x3b9aca00' nonce: '0x5' to: '0x4e1DCf7AD4e460CfD30791CCC4F9c8a4f820ec67' value: '0x0' BatchedSafeOperationsResponse-Output: properties: domain: $ref: >- #/components/schemas/compass__api_backend__v2__models__safe__transact__response__batched_safe_operations__EIP712Domain description: EIP-712 domain separator types: $ref: >- #/components/schemas/compass__api_backend__v2__models__safe__transact__response__batched_safe_operations__EIP712Types description: EIP-712 type definitions primaryType: type: string const: SafeTx title: Primarytype description: Primary type for the structured data message: $ref: '#/components/schemas/SafeTxMessage' description: Safe transaction message data type: object required: - domain - types - primaryType - message title: BatchedSafeOperationsResponse description: Response containing EIP-712 typed data for Safe transaction signing. example: domain: chainId: 8453 verifyingContract: '0x6B90E8B4E3E971E74C1A47a3a20976377E2dB4b1' message: baseGas: '0' data: >- 0x8d80ff0a0000000000000000000000000000000000000000000000000000000000000020 gasPrice: '0' gasToken: '0x0000000000000000000000000000000000000000' nonce: '7' operation: 1 refundReceiver: '0x0000000000000000000000000000000000000000' safeTxGas: '0' to: '0x93C23AAE4793C14D6DF35D2A2A2234204e1559dA' value: '0' primaryType: SafeTx types: EIP712Domain: - name: chainId type: uint256 - name: verifyingContract type: address SafeTx: - name: to type: address - name: value type: uint256 - name: data type: bytes - name: operation type: uint8 - name: safeTxGas type: uint256 - name: baseGas type: uint256 - name: gasPrice type: uint256 - name: gasToken type: address - name: refundReceiver type: address - name: nonce type: uint256 ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError compass__api_backend__v2__models__safe__transact__response__batched_safe_operations__EIP712Domain: properties: chainId: type: integer title: Chainid description: Chain ID verifyingContract: type: string title: Verifyingcontract description: Address of the Product Account type: object required: - chainId - verifyingContract title: EIP712Domain description: The EIP-712 domain separator. compass__api_backend__v2__models__safe__transact__response__batched_safe_operations__EIP712Types: properties: EIP712Domain: items: $ref: '#/components/schemas/EIP712DomainField' type: array title: Eip712Domain description: EIP712Domain type definition SafeTx: items: $ref: '#/components/schemas/SafeTxField' type: array title: Safetx description: SafeTx type definition type: object required: - EIP712Domain - SafeTx title: EIP712Types description: The type definitions for EIP-712 structured data. SafeTxMessage: properties: to: type: string title: To description: Destination address value: type: string title: Value description: Value in wei as a string data: type: string title: Data description: Transaction data as hex string operation: $ref: '#/components/schemas/OperationType' description: Operation type (0=Call, 1=DelegateCall) safeTxGas: type: string title: Safetxgas description: Gas for the transaction baseGas: type: string title: Basegas description: Base gas costs gasPrice: type: string title: Gasprice description: Gas price gasToken: type: string title: Gastoken description: Token address for gas payment refundReceiver: type: string title: Refundreceiver description: Address to receive gas refund nonce: type: string title: Nonce description: Transaction nonce type: object required: - to - value - data - operation - safeTxGas - baseGas - gasPrice - gasToken - refundReceiver - nonce title: SafeTxMessage description: The message data for the transaction. EIP712DomainField: properties: name: type: string title: Name type: type: string title: Type type: object required: - name - type title: EIP712DomainField description: A field in the EIP712Domain type definition. SafeTxField: properties: name: type: string title: Name type: type: string title: Type type: object required: - name - type title: SafeTxField description: A field in the SafeTx type definition. OperationType: type: integer enum: - 0 - 1 title: OperationType description: Safe operation types. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Your Compass API Key. Get your key [here](https://www.compasslabs.ai/dashboard). ````