Skip to main content
POST
/
v1
/
assets
/
send
Send the client's assets
curl --request POST \
  --url https://mpc-client.portalhq.io/v1/assets/send \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "share": "eyJjbG...",
  "chain": "ethereum",
  "to": "0xdFd8302f44727A6348F702fF7B594f127dE3A902",
  "token": "NATIVE",
  "amount": "0.0001",
  "rpcUrl": "https://mainnet.infura.io/v3/YOUR_KEY"
}
'
{
  "transactionHash": "0x02073df9ba08895d681f80ae45440ba57e766602c97ee6321df5ac81bca900cc",
  "metadata": {
    "amount": "0.01",
    "rawAmount": "10000000000000000",
    "tokenAddress": "0xfFf9976782d46CC05630D1f6eBAb18b2324d6B14",
    "tokenDecimals": 18
  }
}

Authorizations

​
Authorization
string
header
required

Client API Key or Client Session Token

Headers

​
Idempotency-Key
string

A unique key to ensure the request is processed only once. If the same key is sent with an identical body, a 409 is returned. If the same key is sent with a different body, a 422 is returned.

Body

application/json

Request body for sending assets.

​
share
string
required

The MPC share for the relevant curve.

​
chain
string
required

The blockchain network. Accepts a CAIP-2 chain ID or a friendly name such as ethereum, solana, polygon, base, sepolia, etc.

​
to
string
required

The recipient's address.

​
token
string
required

Token contract address (ERC-20), mint address (SPL), or a shorthand like NATIVE, USDC, or USDT.

​
amount
string
required

The amount of tokens to send (e.g. "0.1" is 0.1 of the token).

​
rpcUrl
string
required

The RPC node provider URL that the transaction will be submitted through. Not required for Solana or Solana Devnet.

​
nonce
string

Hex string of the nonce to set on the transaction (e.g. "0x01"). Must include the 0x prefix and a leading zero for single digits.

​
metadataStr
string

Optional metadata string for the transaction.

​
sponsorGas
boolean

Set to false to opt out of gas sponsorship for Account Abstraction clients. Defaults to true when omitted.

​
presignature
string

The data value from a presign response. Omit for standard (non-presigned) signing.

Response

Transaction submitted successfully

Response after submitting a send-assets transaction.

​
transactionHash
string
required

The transaction hash (or User Operation hash for Account Abstraction clients).

​
metadata
object