Get Chain Activation Signable Message (Stage 1)

curl --request POST \
  --url 'https://api.glider.fi/v2/portfolios/pf_01JWZEE2MF30KVRMRX53N88VA4/chains/signature' \
  --header 'x-api-key: gldr_sk_your_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "chainIds": [42161]
  }'

const response = await fetch(
  "https://api.glider.fi/v2/portfolios/pf_01JWZEE2MF30KVRMRX53N88VA4/chains/signature",
  {
    method: "POST",
    headers: {
      "x-api-key": "gldr_sk_your_api_key",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ chainIds: [42161] }),
  },
);

{
  "success": true,
  "data": {
    "message": {
      "kind": "ecdsa",
      "raw": "0xdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef"
    }
  }
}

{
  "success": true,
  "data": {
    "message": {
      "kind": "typed-data",
      "typedData": {
        "domain": {
          "name": "ERC1271Validator",
          "version": "0.0.1",
          "chainId": 42161,
          "verifyingContract": "0x9999999999999999999999999999999999999999"
        },
        "types": {
          "MessageHash": [{ "name": "hash", "type": "bytes32" }]
        },
        "primaryType": "MessageHash",
        "message": {
          "hash": "0xdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef"
        }
      }
    }
  }
}

{
  "success": false,
  "error": {
    "code": "API_400",
    "message": "Portfolio already has a vault on chain(s): [42161]"
  }
}

{
  "success": false,
  "error": {
    "code": "API_200",
    "message": "Portfolio with ID pf_01JWZEE2MF30KVRMRX53N88VA4 not found"
  }
}

POST

portfolios

{portfolioId}

chains

signature

curl --request POST \
  --url 'https://api.glider.fi/v2/portfolios/pf_01JWZEE2MF30KVRMRX53N88VA4/chains/signature' \
  --header 'x-api-key: gldr_sk_your_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "chainIds": [42161]
  }'

const response = await fetch(
  "https://api.glider.fi/v2/portfolios/pf_01JWZEE2MF30KVRMRX53N88VA4/chains/signature",
  {
    method: "POST",
    headers: {
      "x-api-key": "gldr_sk_your_api_key",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ chainIds: [42161] }),
  },
);

{
  "success": true,
  "data": {
    "message": {
      "kind": "ecdsa",
      "raw": "0xdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef"
    }
  }
}

{
  "success": true,
  "data": {
    "message": {
      "kind": "typed-data",
      "typedData": {
        "domain": {
          "name": "ERC1271Validator",
          "version": "0.0.1",
          "chainId": 42161,
          "verifyingContract": "0x9999999999999999999999999999999999999999"
        },
        "types": {
          "MessageHash": [{ "name": "hash", "type": "bytes32" }]
        },
        "primaryType": "MessageHash",
        "message": {
          "hash": "0xdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef"
        }
      }
    }
  }
}

{
  "success": false,
  "error": {
    "code": "API_400",
    "message": "Portfolio already has a vault on chain(s): [42161]"
  }
}

{
  "success": false,
  "error": {
    "code": "API_200",
    "message": "Portfolio with ID pf_01JWZEE2MF30KVRMRX53N88VA4 not found"
  }
}

Stage 1 of the two-stage chain-activation flow. A portfolio’s chains are chosen at enrollment (chainIds on POST /v2/enroll); this flow adds smart accounts on additional chains to an already-enrolled portfolio. The endpoint recomputes the session-key message over the requested (new) chains from the portfolio’s existing owner wallet, operating agent, and account index, and returns it for the portfolio owner to sign — the same signature ceremony as enrollment. The message shape follows the portfolio’s account type (determined server-side from how it was enrolled):

ECDSA portfolios get { "kind": "ecdsa", "raw": ... } — a 32-byte digest covering all requested chains, signed via EIP-191 personal_sign.
ERC-1271 portfolios get { "kind": "typed-data", "typedData": ... } — an EIP-712 payload signed with the owner’s smart-contract wallet. One signature covers exactly one chain, so chainIds must contain exactly one entry.

Pass the signature to POST /v2/portfolios/{portfolioId}/chains to activate.

Auth: x-api-key header (required)
Scope: portfolios:write

The call is stateless and deterministic: nothing is reserved, and repeating it with the same chainIds returns the same message. There is no expiry — the signature stays valid until submitted. Current constraints:

EVM portfolios only. Solana portfolios return 400.
ERC-1271 portfolios activate one chain per request; passing more than one chainIds entry returns 400. To activate several chains, repeat the two-stage flow once per chain.
chainIds must not contain duplicates and must not include chains the portfolio already has a smart account on — check smartAccounts on GET /v2/portfolios/{portfolioId} first.
Unknown/unconfigured chains are rejected with 400; the allowed list is in the error details.

Common error responses:

400 when the body is invalid, a chain is already active, a chain is unsupported, the portfolio is Solana, or more than one chain is requested on an ERC-1271 portfolio
401 when x-api-key is missing or invalid
403 when the API key lacks the portfolios:write scope
404 when the portfolio does not exist or belongs to another tenant

curl --request POST \
  --url 'https://api.glider.fi/v2/portfolios/pf_01JWZEE2MF30KVRMRX53N88VA4/chains/signature' \
  --header 'x-api-key: gldr_sk_your_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "chainIds": [42161]
  }'

const response = await fetch(
  "https://api.glider.fi/v2/portfolios/pf_01JWZEE2MF30KVRMRX53N88VA4/chains/signature",
  {
    method: "POST",
    headers: {
      "x-api-key": "gldr_sk_your_api_key",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ chainIds: [42161] }),
  },
);

{
  "success": true,
  "data": {
    "message": {
      "kind": "ecdsa",
      "raw": "0xdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef"
    }
  }
}

{
  "success": true,
  "data": {
    "message": {
      "kind": "typed-data",
      "typedData": {
        "domain": {
          "name": "ERC1271Validator",
          "version": "0.0.1",
          "chainId": 42161,
          "verifyingContract": "0x9999999999999999999999999999999999999999"
        },
        "types": {
          "MessageHash": [{ "name": "hash", "type": "bytes32" }]
        },
        "primaryType": "MessageHash",
        "message": {
          "hash": "0xdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef"
        }
      }
    }
  }
}

{
  "success": false,
  "error": {
    "code": "API_400",
    "message": "Portfolio already has a vault on chain(s): [42161]"
  }
}

{
  "success": false,
  "error": {
    "code": "API_200",
    "message": "Portfolio with ID pf_01JWZEE2MF30KVRMRX53N88VA4 not found"
  }
}

Patch Portfolio Activate Chains on a Portfolio (Stage 2)

B2B API Reference

REST API Endpoints (Legacy V1)

tRPC Endpoints

Internal Admin Endpoints

Get Chain Activation Signable Message (Stage 1)