v1

latestOpenAPI 3.0.32026-08-041747125.8 KB
User Configuration

Get rebalancer configuration

Retrieves the current rebalancing configuration state for a specific wallet address across all supported tokens.

This endpoint returns configurations for each supported token, including:

  • Rebalancer Address: The smart contract address of the user's rebalancer
  • Rebalancing Manager Address: The address of the rebalancing manager contract
  • Configurations: List of configuration items, one per supported token, each containing:
    • Token information
    • Domain IDs, Protocol IDs, and Pool contracts
    • hasSignedConfig: Boolean flag indicating the configuration state for this specific token

Understanding hasSignedConfig (per token):

  • true: The user has signed and set their own custom configuration for this token
  • false: The user has not signed any configuration for this token yet, and the returned values represent the default configuration

When hasSignedConfig is false for a token, the configuration data shows what the default state allows, but it hasn't been actively set by the user for that token. This state must be signed by user to confirm the configuration. Each token can have a different hasSignedConfig status.

Note: Requires a valid API key to query configurations.

Rate limiting: 1 request per 3 seconds per client IP. Excess requests receive HTTP 429 with Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers (see RateLimitExceeded response).

get/v1/config/{walletAddress}

Path parameters

walletAddressstring required

Ethereum wallet address

Response

Configuration retrieved successfully

walletAddressstring required

User's wallet address

rebalancerAddressstring required

Deployed rebalancer contract address

rebalancingManagerAddressstring required

RebalancingManager contract address

rebalancerExistsboolean required

Whether a rebalancer contract has been deployed for this wallet

Example response

{
  "walletAddress": "0x1234567890123456789012345678901234567890",
  "rebalancerAddress": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
  "rebalancingManagerAddress": "0x971ad06e6fde83b0265bd3ced5f5eaf30e269962",
  "rebalancerExists": true,
  "configurations": [
    {
      "token": "USDC",
      "domainIds": [
        11,
        11
      ],
      "protocolIds": [
        0,
        2
      ],
      "poolAddresses": [
        "0xghijklghijklghijklghijklghijklghijklmnop",
        "0xqrstuvqrstuvqrstuvqrstuvqrstuvqrstuvwxy"
      ],
      "totalGasFee": "0.00",
      "lastRebalanceTimestamp": "2025-01-01T00:00:00Z",
      "rebalanceFrequency": 7,
      "hasSignedConfig": true
    }
  ]
}