Accounts

Create external account

Register and authorize one of an investor's own blockchain addresses as an external account.

  • The returned walletId is the identifier to use as a stablecoin-transfer withdrawal destination on create withdrawal order, and the address a stablecoin deposit must originate from.
  • network must be one of the networks enabled for the environment, and address must be a valid address for that network's family.
  • The address must not already be assigned to another investor (409). Re-submitting an address whose account was previously archived reopens that account and returns its original id.
  • An investor may hold at most 100 active external accounts (409).
  • Whitelisting is submitted on-chain asynchronously: a success response means the transaction was launched, not yet confirmed.

⚠️ Only register addresses the investor actually controls. Spiko does not verify ownership on this endpoint, and the address is authorized for payouts on your assertion alone.

post/v0/accounts/external

Request

Request body

network'Ethereum' | 'Polygon' | 'Base' | 'Arbitrum' | 'ArbitrumUk' | 'Etherlink' | 'Starknet' | 'Stellar' | 'Solana' required

a blockchain network e.g. "Ethereum", "Polygon", "Arbitrum", "Starknet"

investorIdstring uuid required

a Universally Unique Identifier

namestring

Response

Success

idstring uuid required

a Universally Unique Identifier

investorIdstring uuid required

a Universally Unique Identifier

walletIdstring uuid required

a Universally Unique Identifier

network'Ethereum' | 'Polygon' | 'Base' | 'Arbitrum' | 'ArbitrumUk' | 'Etherlink' | 'Starknet' | 'Stellar' | 'Solana' required

Deprecated. Use the wallet API instead.

createdAtstring nullable required
shareClassIdsUUID[] required

Changes

No recorded changes to this operation across all 1 revision of this API.