Fund the client's wallet with testnet tokens

curl --request POST \
  --url https://api.portalhq.io/api/v3/clients/me/fund \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "chainId": "eip155:11155111",
  "token": "USDC",
  "amount": "0.1"
}
'

import requests

url = "https://api.portalhq.io/api/v3/clients/me/fund"

payload = {
    "chainId": "eip155:11155111",
    "token": "USDC",
    "amount": "0.1"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({chainId: 'eip155:11155111', token: 'USDC', amount: '0.1'})
};

fetch('https://api.portalhq.io/api/v3/clients/me/fund', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.portalhq.io/api/v3/clients/me/fund",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'chainId' => 'eip155:11155111',
    'token' => 'USDC',
    'amount' => '0.1'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.portalhq.io/api/v3/clients/me/fund"

	payload := strings.NewReader("{\n  \"chainId\": \"eip155:11155111\",\n  \"token\": \"USDC\",\n  \"amount\": \"0.1\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.portalhq.io/api/v3/clients/me/fund")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"chainId\": \"eip155:11155111\",\n  \"token\": \"USDC\",\n  \"amount\": \"0.1\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.portalhq.io/api/v3/clients/me/fund")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"chainId\": \"eip155:11155111\",\n  \"token\": \"USDC\",\n  \"amount\": \"0.1\"\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "explorerUrl": "https://sepolia.etherscan.io/tx/0xabc123...",
    "txHash": "0xabc123..."
  },
  "metadata": {
    "amount": "0.1",
    "chainId": "eip155:11155111",
    "clientId": "clientId",
    "custodianId": "custodianId",
    "environmentId": "environmentId",
    "token": "USDC"
  }
}

Funding

Fund the client's wallet with testnet tokens

Requests testnet tokens for the client’s wallet on a supported testnet chain. Each request funds a caller-specified amount, which must not exceed the per-request maximum for that chain and token. Cumulative successful funding is capped per client, per chain, and per token over a rolling 24-hour window — requests that would exceed the remaining window budget are rejected. The per-request maximum and the 24-hour window budget vary by chain and token.

Supported testnet chains: Sepolia, Base Sepolia, Monad Testnet, Celo Alfajores, Solana Devnet, Tron Nile, Tron Shasta, Stellar Testnet, Bitcoin Segwit Testnet.

POST

clients

fund

Fund the client's wallet with testnet tokens

curl --request POST \
  --url https://api.portalhq.io/api/v3/clients/me/fund \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "chainId": "eip155:11155111",
  "token": "USDC",
  "amount": "0.1"
}
'

import requests

url = "https://api.portalhq.io/api/v3/clients/me/fund"

payload = {
    "chainId": "eip155:11155111",
    "token": "USDC",
    "amount": "0.1"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({chainId: 'eip155:11155111', token: 'USDC', amount: '0.1'})
};

fetch('https://api.portalhq.io/api/v3/clients/me/fund', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.portalhq.io/api/v3/clients/me/fund",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'chainId' => 'eip155:11155111',
    'token' => 'USDC',
    'amount' => '0.1'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.portalhq.io/api/v3/clients/me/fund"

	payload := strings.NewReader("{\n  \"chainId\": \"eip155:11155111\",\n  \"token\": \"USDC\",\n  \"amount\": \"0.1\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.portalhq.io/api/v3/clients/me/fund")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"chainId\": \"eip155:11155111\",\n  \"token\": \"USDC\",\n  \"amount\": \"0.1\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.portalhq.io/api/v3/clients/me/fund")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"chainId\": \"eip155:11155111\",\n  \"token\": \"USDC\",\n  \"amount\": \"0.1\"\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "explorerUrl": "https://sepolia.etherscan.io/tx/0xabc123...",
    "txHash": "0xabc123..."
  },
  "metadata": {
    "amount": "0.1",
    "chainId": "eip155:11155111",
    "clientId": "clientId",
    "custodianId": "custodianId",
    "environmentId": "environmentId",
    "token": "USDC"
  }
}

Authorizations

Authorization

string

header

required

Client API Key or Client Session Token (CST). Pass as a Bearer token in the Authorization header.

Body

application/json

chainId

string

required

The testnet chain ID in CAIP-2 format (e.g. eip155:11155111 for Sepolia).

token

string

required

The token symbol to fund (e.g. USDC, ETH).

amount

string

required

The amount to fund as a numeric string. Must be greater than zero.

Response

Fund request processed. The response contains either data (on success) or error (on failure), but not both.

data

object | null

Present on success, null on failure.

Show child attributes

error

object | null

Present on failure, null on success.

Show child attributes

metadata

object

Show child attributes

Overview

Enclave MPC API

Client API

Authentication API

Custodian API

Reseller API

Fund the client's wallet with testnet tokens

Authorizations

Body

Response