curl --request POST \
  --url https://api.sand.etherfuse.com/ramp/customer/{customer_id}/wallet \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "publicKey": "GDUKMGUGD3V6VXTU2RLAUM7A2FABLMHCPWTMDHKP7HHJ6FCZKEY4PVWL",
  "blockchain": "stellar"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    publicKey: 'GDUKMGUGD3V6VXTU2RLAUM7A2FABLMHCPWTMDHKP7HHJ6FCZKEY4PVWL',
    blockchain: 'stellar'
  })
};

fetch('https://api.sand.etherfuse.com/ramp/customer/{customer_id}/wallet', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.sand.etherfuse.com/ramp/customer/{customer_id}/wallet"

payload = {
    "publicKey": "GDUKMGUGD3V6VXTU2RLAUM7A2FABLMHCPWTMDHKP7HHJ6FCZKEY4PVWL",
    "blockchain": "stellar"
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "blockchain": "stellar",
  "claimedOwnership": true,
  "createdAt": "2026-05-01T14:30:00Z",
  "customerId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "kycStatus": "approved",
  "publicKey": "GDUKMGUGD3V6VXTU2RLAUM7A2FABLMHCPWTMDHKP7HHJ6FCZKEY4PVWL",
  "updatedAt": "2026-05-02T09:15:00Z",
  "walletId": "c3d4e5f6-a7b8-9012-cdef-123456789012"
}

Wallets

Register customer wallet

Registers a crypto wallet for a customer that belongs to the caller’s organization or a direct child organization. Mirrors POST /ramp/wallet but scoped to a specific customer within the caller’s org hierarchy.

This endpoint only accepts bring-your-own (external) wallets (publicKey + blockchain). Embedded-wallet provisioning is not supported for customer wallets. Use POST /ramp/wallet for the organization instead.

If the wallet was previously soft-deleted, it is restored. Optionally claims ownership of the wallet on behalf of the customer’s organization.

Idempotent: registering an already-active wallet returns the existing record.

POST

ramp

customer

{customer_id}

wallet

curl --request POST \
  --url https://api.sand.etherfuse.com/ramp/customer/{customer_id}/wallet \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "publicKey": "GDUKMGUGD3V6VXTU2RLAUM7A2FABLMHCPWTMDHKP7HHJ6FCZKEY4PVWL",
  "blockchain": "stellar"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    publicKey: 'GDUKMGUGD3V6VXTU2RLAUM7A2FABLMHCPWTMDHKP7HHJ6FCZKEY4PVWL',
    blockchain: 'stellar'
  })
};

fetch('https://api.sand.etherfuse.com/ramp/customer/{customer_id}/wallet', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.sand.etherfuse.com/ramp/customer/{customer_id}/wallet"

payload = {
    "publicKey": "GDUKMGUGD3V6VXTU2RLAUM7A2FABLMHCPWTMDHKP7HHJ6FCZKEY4PVWL",
    "blockchain": "stellar"
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "blockchain": "stellar",
  "claimedOwnership": true,
  "createdAt": "2026-05-01T14:30:00Z",
  "customerId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "kycStatus": "approved",
  "publicKey": "GDUKMGUGD3V6VXTU2RLAUM7A2FABLMHCPWTMDHKP7HHJ6FCZKEY4PVWL",
  "updatedAt": "2026-05-02T09:15:00Z",
  "walletId": "c3d4e5f6-a7b8-9012-cdef-123456789012"
}

Authorizations

Authorization

string

header

required

API key sent in the Authorization header.

Path Parameters

customer_id

string<uuid>

required

The customer (child org) ID. Must belong to the caller's organization or a direct child.

Body

application/json

publicKey

string

required

Wallet public key / address.

blockchain

enum<string>

required

Target blockchain.

Available options:

stellar,

solana,

base,

polygon,

monad

claimOwnership

boolean

Claim org ownership of the wallet for compliance attribution. Defaults to false.

Response

The registered wallet

blockchain

enum<string>

required

Blockchain the wallet is on.

Available options:

stellar,

solana,

base,

polygon,

monad

createdAt

string<date-time>

required

Timestamp when the wallet was created.

customerId

string<uuid>

required

ID of the customer who owns this wallet.

publicKey

string

required

Public key / address of the wallet.

updatedAt

string<date-time>

required

Timestamp when the wallet was last updated.

walletId

string<uuid>

required

Unique identifier for the wallet.

claimedOwnership

boolean | null

Whether the wallet has active claimed ownership by the organization. When true and the organization is approved, the wallet is treated as compliant without requiring individual KYC. Only present when claimed ownership has been set.

deletedAt

string<date-time> | null

Timestamp when the wallet was deleted (if applicable).

displayName

string | null

Display name for the wallet.

kycOnChain

boolean | null

Whether KYC is marked on-chain for the wallet. Only present for Solana wallets; for other blockchains this field is omitted as on-chain KYC marking does not apply.

kycStatus

string | null

Current KYC verification status for the wallet. Only present for individual wallet calls. The approved_chain_deploying status indicates the user is approved but waiting for on-chain marking (Solana only).

signerPublicKey

string | null

For embedded (non-custodial) wallets, the compressed SEC1 P-256 public key of the owner key that authorizes transactions. Absent for bring-your-own wallets.

Search wallets List customer wallets

⌘I

User Authentication

Ramp API

Lookup API

Register customer wallet

Authorizations

Path Parameters

Body

Response