Skip to main content
POST
/
v2
/
portfolio-wallets
Create a portfolio wallet
curl --request POST \
  --url https://sandbox.trybraid.xyz/v2/portfolio-wallets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "requestId": "0b7e3b4d-88a5-4a75-8c0f-3b7b4f9d9f1d",
  "label": "Treasury Portfolio",
  "positions": [
    {
      "positionKey": "tbills",
      "targetWeightBps": 6000,
      "currentApy": 330,
      "maxProcessingTime": "PT0H"
    },
    {
      "positionKey": "resolvRlp",
      "targetWeightBps": 4000,
      "currentApy": 850,
      "maxProcessingTime": "PT24H"
    }
  ]
}
'
{
  "id": "9d1a1c83-3a1c-4c14-9c5a-0c9a57a4a7db",
  "requestId": "0b7e3b4d-88a5-4a75-8c0f-3b7b4f9d9f1d",
  "label": "Treasury Portfolio",
  "status": "active",
  "createdAt": "2026-02-05T08:15:00.000Z",
  "updatedAt": "2026-02-05T10:05:00.000Z",
  "totalBalanceUsd": 92500,
  "instantWithdrawableUsd": 52500,
  "pendingAllocationsUsd": 10000,
  "depositAddresses": {
    "arbitrum": {
      "address": "0x21246509968c4d24611f414560971AEc2e3A079B",
      "totalBalanceUsd": 52500,
      "pendingAllocationsUsd": 0
    },
    "avalanche": {
      "address": "0x21246509968c4d24611f414560971AEc2e3A079B",
      "totalBalanceUsd": 0,
      "pendingAllocationsUsd": 0
    },
    "base": {
      "address": "0x21246509968c4d24611f414560971AEc2e3A079B",
      "totalBalanceUsd": 0,
      "pendingAllocationsUsd": 0
    },
    "bsc": {
      "address": "0x21246509968c4d24611f414560971AEc2e3A079B",
      "totalBalanceUsd": 0,
      "pendingAllocationsUsd": 0
    },
    "ethereum": {
      "address": "0x21246509968c4d24611f414560971AEc2e3A079B",
      "totalBalanceUsd": 40000,
      "pendingAllocationsUsd": 10000
    },
    "optimism": {
      "address": "0x21246509968c4d24611f414560971AEc2e3A079B",
      "totalBalanceUsd": 0,
      "pendingAllocationsUsd": 0
    },
    "solana": {
      "address": "7qjT9B7i8wM1tGmW9o6oYtNwqgQF5s9gF8XqNwTgF9n2",
      "totalBalanceUsd": 0,
      "pendingAllocationsUsd": 0
    }
  },
  "blendedRateBps": 538,
  "strategyConfig": {
    "positions": [
      {
        "positionKey": "tbills",
        "targetWeightBps": 6000,
        "maxProcessingTime": "PT0H",
        "asset": "tbills"
      },
      {
        "positionKey": "resolvRlp",
        "targetWeightBps": 4000,
        "maxProcessingTime": "PT24H",
        "asset": "rlp"
      }
    ]
  },
  "liquidityProfile": [
    {
      "maxProcessingTime": "PT0H",
      "weightBps": 6000
    },
    {
      "maxProcessingTime": "PT24H",
      "weightBps": 4000
    }
  ],
  "positions": [
    {
      "positionKey": "tbills",
      "meta": {
        "asset": "tbills",
        "maxProcessingTime": "PT0H"
      },
      "targetWeightBps": 6000,
      "balanceUnits": 52500,
      "valueUsd": 52500,
      "weightBps": 6000.4,
      "currentApyBps": 330,
      "driftBps": 0.4
    },
    {
      "positionKey": "resolvRlp",
      "meta": {
        "asset": "rlp",
        "maxProcessingTime": "PT24H"
      },
      "targetWeightBps": 4000,
      "balanceUnits": 25000,
      "valueUsd": 30000,
      "weightBps": 3999.6,
      "currentApyBps": 850,
      "driftBps": -0.4
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
requestId
string<uuid>
required

Unique idempotency key for wallet creation.

​
positions
object[]
required

Positions must sum to 10000 bps. Only positionKey and targetWeightBps are used; extra fields per position are accepted but ignored.

​
label
string

Response

Portfolio wallet created

​
id
string<uuid>
required
​
requestId
string<uuid>
required
​
status
string
required
​
createdAt
string<date-time>
required
​
updatedAt
string<date-time>
required
​
strategyConfig
object
required
​
totalBalanceUsd
number<double>
required
​
instantWithdrawableUsd
number<double>
required
​
pendingAllocationsUsd
number<double>
required
​
depositAddresses
object
required

Deposit addresses and balances by chain. Known keys include ethereum, solana, bsc, avalanche, arbitrum, base, optimism. New chains may be added over time.

​
liquidityProfile
object[]
required
​
blendedRateBps
number<double>
required
​
positions
object[]
required
​
label
string | null