curl --request POST \
--url https://api.sand.etherfuse.com/ramp/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/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/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",
"publicKey": "GDUKMGUGD3V6VXTU2RLAUM7A2FABLMHCPWTMDHKP7HHJ6FCZKEY4PVWL",
"updatedAt": "2026-05-02T09:15:00Z",
"walletId": "c3d4e5f6-a7b8-9012-cdef-123456789012"
}Register wallet
Registers a crypto wallet for the authenticated organization. If the wallet was previously soft-deleted, it is restored.
Optionally claims ownership of the wallet on behalf of the organization. When an approved (KYB’d) organization claims ownership, that wallet is treated as compliant without requiring individual KYC verification.
Idempotent — registering an already-active wallet returns the existing record.
curl --request POST \
--url https://api.sand.etherfuse.com/ramp/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/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/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",
"publicKey": "GDUKMGUGD3V6VXTU2RLAUM7A2FABLMHCPWTMDHKP7HHJ6FCZKEY4PVWL",
"updatedAt": "2026-05-02T09:15:00Z",
"walletId": "c3d4e5f6-a7b8-9012-cdef-123456789012"
}Body
- Bring-your-own wallet
- Embedded wallet
Request body for registering a wallet. Two mutually-exclusive shapes: bring-your-own (external): provide publicKey and blockchain; or embedded (non-custodial): provide walletId and a signer with the owner's P-256 public key as compressed SEC1 hex (signerPublicKey), PEM (signerPublicKeyPem), or JWK (signerPublicKeyJwk). Only p256 is supported for embedded wallets. Supply exactly one key encoding. Supplying both external and embedded fields is rejected.
Response
The registered wallet