v32

latestOpenAPI 3.0.0raw.githubusercontent.com2026-07-076085232.1 KB

Partner Accounts

Check partner account allowances

Checks delegated-trading allowance readiness for a partner-created server-wallet sub-account. Requires HMAC authentication with account_creation and delegated_signing scopes. Status is based on live chain reads.

get/profiles/partner-accounts/{profileId}/allowances

Path parameters

profileIdinteger required

Partner sub-account profile ID for the server-wallet child account.

Response

Live allowance state for the server-wallet child profile

profileIdinteger required

Child/server-wallet profile ID being checked

partnerProfileIdinteger required

Authenticated parent partner profile ID

chainIdinteger required

Chain where allowance targets were checked

walletAddressstring required

Managed server-wallet address for the child profile

readyboolean required

True when every target is confirmed on chain

Example response

{
  "profileId": 4543,
  "partnerProfileId": 4430,
  "chainId": 84532,
  "walletAddress": "0x1a665817f063Ee15C6C2c05D4315982145825C3D",
  "summary": {
    "total": 10,
    "confirmed": 2,
    "submitted": 8
  },
  "targets": [
    {
      "type": "USDC_ALLOWANCE",
      "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "spenderOrOperator": "0x54d696A602343063000B25a51734E3BbE0Ec80a2",
      "label": "ctf-exchange",
      "requiredFor": "BUY",
      "status": "submitted",
      "transactionId": "tx_abc123",
      "txHash": "0xabc123...",
      "userOperationHash": "0xdef456...",
      "retryable": true,
      "errorCode": "RPC_READ_FAILED"
    }
  ]
}