Skip to main content
POST
/
ramp
/
wallet
Register a crypto wallet
curl --request POST \
  --url https://api.etherfuse.com/ramp/wallet \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "publicKey": "9Qx7r...",
  "blockchain": "solana",
  "claimOwnership": true
}
'
{
  "walletId": "123e4567-e89b-12d3-a456-426614174000",
  "customerId": "123e4567-e89b-12d3-a456-426614174001",
  "createdAt": "2024-01-01T00:00:00Z",
  "updatedAt": "2024-01-01T00:00:00Z",
  "publicKey": "9Qx7r...",
  "blockchain": "solana",
  "isAuthenticated": true,
  "kycStatus": "approved",
  "kycOnChain": true,
  "claimedOwnership": true
}

Authorizations

​
Authorization
string
header
required

API key for authentication. Pass the key directly (e.g., Authorization: your-api-key). Do not use a Bearer prefix.

Body

application/json
​
publicKey
string
required

The public key of the crypto wallet to register

​
blockchain
enum<string>
required

Blockchain type for the wallet

Available options:
solana,
stellar,
base,
polygon,
monad
​
claimOwnership
boolean
default:false

If true, the organization claims ownership of this wallet. Combined with an approved org, this makes the wallet compliant without individual KYC.

Response

Wallet registered successfully

​
walletId
string<uuid>

Unique identifier for the wallet

​
customerId
string<uuid>

ID of the customer who owns this wallet

​
createdAt
string<date-time>

Timestamp when the wallet was created

​
updatedAt
string<date-time>

Timestamp when the wallet was last updated

​
deletedAt
string<date-time> | null

Timestamp when the wallet was deleted (if applicable)

​
displayName
string | null

Display name for the wallet

​
publicKey
string

Public key of the wallet

​
blockchain
enum<string>

Blockchain type

Available options:
solana,
stellar,
base,
polygon,
monad
​
isAuthenticated
boolean

Whether the wallet is authenticated

​
kycStatus
enum<string> | null

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

Available options:
not_started,
proposed,
approved,
approved_chain_deploying,
rejected
​
kycOnChain
boolean | null

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

​
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.