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

Check partner account allowances

cURL

curl --request GET \
  --url https://api.limitless.exchange/profiles/partner-accounts/{profileId}/allowances \
  --header 'lmts-api-key: <api-key>'

200

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

Requires HMAC authentication with the account_creation and delegated_signing scopes. API key auth and Privy auth are not accepted.

Checks delegated-trading allowance readiness for a partner-created server-wallet sub-account. The response is based on live chain reads.

• Route: GET /profiles/partner-accounts/:profileId/allowances
• Auth: HMAC api-token auth
• Scopes: account_creation + delegated_signing
• profileId: child/server-wallet profile id that belongs to the authenticated partner

Path parameters

Parameter	Type	Required	Description
profileId	number	Yes	Partner sub-account profile id for the server-wallet child account.

Response

{
  "profileId": 4543,
  "partnerProfileId": 4430,
  "chainId": 84532,
  "walletAddress": "0x1a665817f063Ee15C6C2c05D4315982145825C3D",
  "ready": false,
  "summary": {
    "total": 10,
    "confirmed": 0,
    "missing": 2,
    "submitted": 0,
    "failed": 8
  },
  "targets": [
    {
      "type": "USDC_ALLOWANCE",
      "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "spenderOrOperator": "0x54d696A602343063000B25a51734E3BbE0Ec80a2",
      "label": "ctf-exchange",
      "requiredFor": "BUY",
      "confirmed": false,
      "status": "missing",
      "retryable": true
    }
  ]
}

Response fields

Field	Type	Description
profileId	number	Child/server-wallet profile id being checked.
partnerProfileId	number	Authenticated parent partner profile id.
chainId	number	Chain where allowance targets were checked.
walletAddress	string	Managed server-wallet address for the child profile.
ready	boolean	true when every target is confirmed on chain.
summary.total	number	Total target count.
summary.confirmed	number	Targets confirmed on chain.
summary.missing	number	Targets still missing.
summary.submitted	number	Targets submitted by the current retry response. For GET responses this is usually 0.
summary.failed	number	Targets whose latest live read or retry state failed.
targets[]	array	Per-target allowance or approval state.

Target fields

Field	Type	Description
type	USDC_ALLOWANCE | CTF_APPROVAL	Target category.
tokenAddress	string	ERC20 or conditional-token contract address.
spenderOrOperator	string	Allowance spender or operator address.
label	string	Human-readable target label.
requiredFor	BUY | SELL	Trading side that requires this approval.
confirmed	boolean	Whether this target is confirmed on chain.
status	confirmed | missing | submitted | failed	Current target status.
retryable	boolean	Whether POST /retry may attempt this target.
transactionId	string	Optional sponsored transaction id when submitted.
txHash	string	Optional transaction hash when available.
userOperationHash	string	Optional user operation hash when available.
errorCode	string	Optional machine-readable failure code, such as RPC_READ_FAILED.
errorMessage	string	Optional human-readable failure message.

Recommended flow

1. Poll this endpoint.
2. If ready=true, continue with delegated trading.
3. If targets are missing or failed and retryable=true, call Retry Partner Account Allowances.
4. If retry submits targets, poll this endpoint again after a short delay.

Example

curl "https://api.limitless.exchange/profiles/partner-accounts/4543/allowances" \
  -H "lmts-api-key: <tokenId>" \
  -H "lmts-signature: <base64_hmac_sha256_signature>" \
  -H "lmts-timestamp: <iso_8601_timestamp>"

Authorizations

lmts-api-key · string · header · required

Scoped API token with HMAC-SHA256 signing. Requires three headers: lmts-api-key (token ID), lmts-timestamp (ISO-8601), lmts-signature (Base64-encoded HMAC). See Authentication docs for details.

Path Parameters

profileId · integer · required

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

Response

200

application/json

Live allowance state for the server-wallet child profile

profileId · integer · required

Child/server-wallet profile ID being checked

Example:

4543

partnerProfileId · integer · required

Authenticated parent partner profile ID

Example:

4430

chainId · integer · required

Chain where allowance targets were checked

Example:

84532

walletAddress · string · required

Managed server-wallet address for the child profile

Example:

"0x1a665817f063Ee15C6C2c05D4315982145825C3D"

ready · boolean · required

True when every target is confirmed on chain

Example:

false

summary · object · required

Show child attributes

targets · object[] · required

Show child attributes