V1 endpoints

These endpoints require a Client API Key or Client Session Token (CST) as a bearer token.

Create Wallets

POST https://mpc-client.portalhq.io/v1/generate

This endpoint generates MPC shares for both SECP256K1 (EVM, etc) and ED25519 (Solana, XRP, etc) curves.

Headers

Name	Type	Description
Authorization*	String	Bearer <Client API Key>
Content-Type*	String	application/json

Request Body

You can leave this empty.

Response Body

200: OK Success

{
  "SECP256K1": {
    "share": "eyJjbG...",
    "id": "cm0r6nkek00ej10dwwx8wdjmf"
  },
  "ED25519": {
    "share": "eyJjbG...",
    "id": "cm0r6nk7c00hbzefaq9s93s0x"
  }
}

400: Bad Request Bad Request

{
  "error": {
    "code": 111,
    "prefix": "",
    "error": "ERROR_TYPE",
    "message": "Some message"
  }
}

401: Unauthorized Unauthorized Request

{
  "error": {
    "code": 111,
    "prefix": "",
    "error": "ERROR_TYPE",
    "message": "Some message"
  }
}

Send Assets

POST https://mpc-client.portalhq.io/v1/assets/send

This endpoint allows you to easily send a token to another address.

Headers

Name	Type	Description
Authorization*	String	Bearer <Client API Key>
Content-Type*	String	application/json

Request Body

Name	Type	Description
share*	String	The MPC share generated from "Create Wallets" for a specific curve.
chain*	String	The blockchain network (e.g. "ethereum", "sepolia", "solana", "solana-devnet", or a CAIP-2 chain ID like "eip155:11155111")
to*	String	The recipient's address.
token*	String	The token contract address (for ERC20 tokens on EVM chains) or the mint address (for Solana SPL tokens). You can also use "USDC" or "USDT" for the respective tokens. For native token transfers, use "ETH" or "SOL".
amount*	String	The amount of tokens to send ("0.1" is 0.1 USDC)
rpcUrl	String	The node provider RPC URL. Not required for Solana or Solana Devnet.
metadataStr	String	Optional metadata string for the transaction.

Response Body

200: OK Success

{
  "transactionHash": "0x02073df9ba08895d681f80ae45440ba57e766602c97ee6321df5ac81bca900cc",
  "metadata": {
    "formattedAmount": "0.01",
    "rawAmount": "10000000000000000",
    "tokenAddress": "0xfFf9976782d46CC05630D1f6eBAb18b2324d6B14",
    "tokenDecimals": 18
  }
}

If your client is using Account Abstraction, then transactionHash is actually a User Operation hash. You can manually look up the user operation hash here.

400: Bad Request Bad Request

{
  "error": {
    "code": 111,
    "prefix": "",
    "error": "ERROR_TYPE",
    "message": "Some message"
  }
}

401: Unauthorized Unauthorized Request

{
  "error": {
    "code": 111,
    "prefix": "",
    "error": "ERROR_TYPE",
    "message": "Some message"
  }
}

Submit Transaction

POST https://mpc-client.portalhq.io/v1/sign

This endpoint allows you to sign a transaction or message.

Headers

Name	Type	Description
Authorization*	String	Bearer <Client API Key>
Content-Type*	String	application/json

Request Body

Response Body

200: OK Success

{
  "data": "0xf7a6a07fa599db56fca50fa1202670b59054e7ed452ea57b3f5b43148b8bdb165beb3a4b0fd532162a1f0fd475de1a9ecd07c95186f7a0856ce1bffa45e3acc91b"
}

400: Bad Request Bad Request

{
  "error": {
    "code": 111,
    "prefix": "",
    "error": "ERROR_TYPE",
    "message": "Some message"
  }
}

401: Unauthorized Unauthorized Request

{
  "error": {
    "code": 111,
    "prefix": "",
    "error": "ERROR_TYPE",
    "message": "Some message"
  }
}

Sign Raw Message

POST https://mpc-client.portalhq.io/v1/raw/sign/:curve

This endpoint allows you to sign a raw message.

Headers

Request Path Params

Request Body

Response Body

200: OK Success

{
  "data": "0xf7a6a07fa599db56fca50fa1202670b59054e7ed452ea57b3f5b43148b8bdb165beb3a4b0fd532162a1f0fd475de1a9ecd07c95186f7a0856ce1bffa45e3acc91b"
}

400: Bad Request Bad Request

{
  "error": {
    "code": 111,
    "prefix": "",
    "error": "ERROR_TYPE",
    "message": "Some message"
  }
}

401: Unauthorized Unauthorized Request

{
  "error": {
    "code": 111,
    "prefix": "",
    "error": "ERROR_TYPE",
    "message": "Some message"
  }
}

Back Up Wallets

POST https://mpc-client.portalhq.io/v1/backup

This endpoint allows you to create backup shares for your wallets.

Headers

Request Body

Response Body

200: OK Success

{
  "secp256k1": {
    "share": "eyJjbGl...",
    "id": "clu32l6c8008wuvz52jokyo3r"
  },
  "ed25519": {
    "share": "eyJjbGl...",
    "id": "clu32l9310087evz5u5v9k1ao"
  }
}

400: Bad Request Bad Request

{
  "error": {
    "code": 111,
    "prefix": "",
    "error": "ERROR_TYPE",
    "message": "Some message"
  }
}

401: Unauthorized Unauthorized Request

{
  "error": {
    "code": 111,
    "prefix": "",
    "error": "ERROR_TYPE",
    "message": "Some message"
  }
}

Recover Wallets

POST https://mpc-client.portalhq.io/v1/recover

This endpoint allows you to recover shares for your wallets using your backup shares.

Headers

Request Body

Response Body

200: OK Success

{
  "secp256k1": {
    "share": "eyJjbGl...",
    "id": "clu32l6c8008wuvz52jokyo3r"
  },
  "ed25519": {
    "share": "eyJjbGl...",
    "id": "clu32l9310087evz5u5v9k1ao"
  }
}

400: Bad Request Bad Request

{
  "error": {
    "code": 111,
    "prefix": "",
    "error": "ERROR_TYPE",
    "message": "Some message"
  }
}

401: Unauthorized Unauthorized Request

{
  "error": {
    "code": 111,
    "prefix": "",
    "error": "ERROR_TYPE",
    "message": "Some message"
  }
}