Skip to main content
POST
/
agent
/
fees
/
set
{
    "scope": "org",
    "data": {
        "shekel_buyback": {
            "fee": 0.25,
            "feeAddress": "0x20deD6433c5F9fa2c7a0Aa1Acf86A9d1330f09a5",
            "type": "FLAT",
            "feeLevel": "manager"
        },
        "loky": {
            "fee": 0.075,
            "feeAddress": "0x82fA02070045e66775A0E60662Df77823a86E360",
            "type": "FLAT",
            "feeLevel": "manager"
        },
        "shekel": {
            "fee": 3.5,
            "feeAddress": "0x48597AfA1c4e7530CA8889bA9291494757FEABD2",
            "type": "BPS",
            "feeLevel": "subscriber"
        },
        "phala": {
            "fee": 0.1,
            "feeAddress": "0xD1D9Ada227eCfcAb1Dc6f3715A538fb09Bfc402b",
            "type": "FLAT",
            "feeLevel": "manager"
        },
        "rei": {
            "fee": 0.8,
            "feeAddress": "0x8EAA52Ef427E5710921d5Abe424896F5f6B1a4D9",
            "type": "FLAT",
            "feeLevel": "manager"
        },
        "symphony": {
            "fee": 1.5,
            "feeAddress": "0x56d0573C786d3DBAd5669F6deD961031AD5baDD9",
            "type": "BPS",
            "feeLevel": "subscriber"
        }
    }
}

{
    "status": "success",
    "scope": "org",
    "organization": "Symphony",
    "agentId": null,
    "upserted": 6,
    "disabled": 0,
    "feeData": [
        {
            "partner": "shekel_buyback",
            "fee": 0.25,
            "feeAddress": "0x20ded6433c5f9fa2c7a0aa1acf86a9d1330f09a5",
            "feeType": "flat",
            "agentType": null
        },
        {
            "partner": "loky",
            "fee": 0.075,
            "feeAddress": "0x82fa02070045e66775a0e60662df77823a86e360",
            "feeType": "flat",
            "agentType": null
        },
        {
            "partner": "shekel",
            "fee": 3.5,
            "feeAddress": "0x48597afa1c4e7530ca8889ba9291494757feabd2",
            "feeType": "bps",
            "agentType": null
        },
        {
            "partner": "phala",
            "fee": 0.1,
            "feeAddress": "0xd1d9ada227ecfcab1dc6f3715a538fb09bfc402b",
            "feeType": "flat",
            "agentType": null
        },
        {
            "partner": "rei",
            "fee": 0.8,
            "feeAddress": "0x8eaa52ef427e5710921d5abe424896f5f6b1a4d9",
            "feeType": "flat",
            "agentType": null
        },
        {
            "partner": "symphony",
            "fee": 1.5,
            "feeAddress": "0x56d0573c786d3dbad5669f6ded961031ad5badd9",
            "feeType": "bps",
            "agentType": null
        }
    ]
}
This endpoint is used to set organization level fees and/or agent level fees. If the scope is org then the fees will be set at the organization level. If the scope is agent then the fees will be set at the agent level. If the scope is agent then a valid agentId must be provided. The fee data must follow the format below and include at least one partner. Each fee partner must include:
  • fee: the fee amount in USDC (for flat fees) or a percentage (for BPS fees)
  • feeAddress: the fee address (fee recipient address)
  • type: the fee type (must be one of the following: FLAT or BPS)
  • feeLevel: the fee level (‘manager’ fees paid by agent manager ONLY, ‘subscriber’ fees paid by subscribers and agent manager)
​
scope
string
required
Scope of fees: org for organization level or agent for agent level
​
agentId
string
Required if scope is agent. The agent ID (UUID format)
​
data
object
required
Fee data object with partner names as keys. Each partner object must contain:
​
status
string
Status of the operation
​
scope
string
The scope that was updated
​
organization
string
Organization name
​
agentId
string
Agent ID (if scope is agent)
​
upserted
number
Number of fees upserted
​
disabled
number
Number of fees disabled
​
feeData
array
Array of fee data objects

​
Authentication

Privy Auth

​
Request Example

{
    "scope": "org",
    "data": {
        "shekel_buyback": {
            "fee": 0.25,
            "feeAddress": "0x20deD6433c5F9fa2c7a0Aa1Acf86A9d1330f09a5",
            "type": "FLAT",
            "feeLevel": "manager"
        },
        "loky": {
            "fee": 0.075,
            "feeAddress": "0x82fA02070045e66775A0E60662Df77823a86E360",
            "type": "FLAT",
            "feeLevel": "manager"
        },
        "shekel": {
            "fee": 3.5,
            "feeAddress": "0x48597AfA1c4e7530CA8889bA9291494757FEABD2",
            "type": "BPS",
            "feeLevel": "subscriber"
        },
        "phala": {
            "fee": 0.1,
            "feeAddress": "0xD1D9Ada227eCfcAb1Dc6f3715A538fb09Bfc402b",
            "type": "FLAT",
            "feeLevel": "manager"
        },
        "rei": {
            "fee": 0.8,
            "feeAddress": "0x8EAA52Ef427E5710921d5Abe424896F5f6B1a4D9",
            "type": "FLAT",
            "feeLevel": "manager"
        },
        "symphony": {
            "fee": 1.5,
            "feeAddress": "0x56d0573C786d3DBAd5669F6deD961031AD5baDD9",
            "type": "BPS",
            "feeLevel": "subscriber"
        }
    }
}

​
Response Example

{
    "status": "success",
    "scope": "org",
    "organization": "Symphony",
    "agentId": null,
    "upserted": 6,
    "disabled": 0,
    "feeData": [
        {
            "partner": "shekel_buyback",
            "fee": 0.25,
            "feeAddress": "0x20ded6433c5f9fa2c7a0aa1acf86a9d1330f09a5",
            "feeType": "flat",
            "agentType": null
        },
        {
            "partner": "loky",
            "fee": 0.075,
            "feeAddress": "0x82fa02070045e66775a0e60662df77823a86e360",
            "feeType": "flat",
            "agentType": null
        },
        {
            "partner": "shekel",
            "fee": 3.5,
            "feeAddress": "0x48597afa1c4e7530ca8889ba9291494757feabd2",
            "feeType": "bps",
            "agentType": null
        },
        {
            "partner": "phala",
            "fee": 0.1,
            "feeAddress": "0xd1d9ada227ecfcab1dc6f3715a538fb09bfc402b",
            "feeType": "flat",
            "agentType": null
        },
        {
            "partner": "rei",
            "fee": 0.8,
            "feeAddress": "0x8eaa52ef427e5710921d5abe424896f5f6b1a4d9",
            "feeType": "flat",
            "agentType": null
        },
        {
            "partner": "symphony",
            "fee": 1.5,
            "feeAddress": "0x56d0573c786d3dbad5669f6ded961031ad5badd9",
            "feeType": "bps",
            "agentType": null
        }
    ]
}