XPTransfersV2

Create XP Transfer

Transfer XP instantly from your account to another user.

post/xp/transfer

Request body

amountinteger required

Amount of XP to transfer (must be >= 1 and <= 1e12)

is_privateboolean

Whether the transfer is private (not shown on public feeds). Defaults to false if not provided.

recipientstring required

Recipient's Starknet address (hex format)

seasonstring

Season identifier. Defaults to season3 if not provided.

Example request

{
  "amount": 100,
  "recipient": "0x1234567890abcdef0123456789abcdef",
  "season": "season3"
}

Response

Transfer created successfully

Example response

{
  "transfer": {
    "amount": 100,
    "created_at": 1640995200000,
    "fee": 1,
    "id": "transfer_123",
    "recipient": "0xfedcba0987654321",
    "season": "season2",
    "sender": "0x1234567890abcdef"
  }
}

Changes

Changed in 12 of the 65 revisions of this API.59728

Jul 27, 20262b7343d38fd71See the full diff
- ●
  the request property's max was set to 1000000000000.00
  request-property-max-set
Jul 17, 2026f1370c46e9e89See the full diff
- ●
  added the new BLOCK_TRADE_REPLAYED_SIGNATURE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_REPLAYED_SIGNATURE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_REPLAYED_SIGNATURE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new EVM_VAULT_OPERATORS_DISABLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new EVM_VAULT_OPERATORS_DISABLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new EVM_VAULT_OPERATORS_DISABLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new VAULT_DATA_PRIVATE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new VAULT_DATA_PRIVATE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new VAULT_DATA_PRIVATE enum value to the //// response property for the response status
  response-property-enum-value-added
Jun 17, 2026f3533c17acc21See the full diff
- ○
  the request property default value changed from season2 to season3
  request-property-default-value-changed
Jun 9, 202643b81de9b0799See the full diff
- ○
  removed the INVALID_RHINOFI_QUOTE enum value from the //// response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_RHINOFI_QUOTE enum value from the //// response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_RHINOFI_QUOTE enum value from the //// response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_RHINOFI_QUOTE_COMMIT enum value from the //// response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_RHINOFI_QUOTE_COMMIT enum value from the //// response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_RHINOFI_QUOTE_COMMIT enum value from the //// response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_RHINOFI_REQUEST enum value from the //// response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_RHINOFI_REQUEST enum value from the //// response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_RHINOFI_REQUEST enum value from the //// response property for the response status
  response-property-enum-value-removed
May 21, 20267861dbd35cf56See the full diff
- ●
  added the new IP_NOT_ALLOWED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new IP_NOT_ALLOWED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new IP_NOT_ALLOWED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new MARKET_NOT_SETTLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new MARKET_NOT_SETTLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new MARKET_NOT_SETTLED enum value to the //// response property for the response status
  response-property-enum-value-added
May 7, 2026d24c9b025e4b6See the full diff
- ●
  added the new BLOCK_TRADE_INVALID_SIGNATURE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_INVALID_SIGNATURE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_INVALID_SIGNATURE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_SIGNER_KEY_UNAUTHORIZED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_SIGNER_KEY_UNAUTHORIZED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_SIGNER_KEY_UNAUTHORIZED enum value to the //// response property for the response status
  response-property-enum-value-added
May 4, 20266540e7a44a8312See the full diff
- ●
  added the new EVM_ADDRESS_ALREADY_ONBOARDED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new EVM_ADDRESS_ALREADY_ONBOARDED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new EVM_ADDRESS_ALREADY_ONBOARDED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new INSUFFICIENT_EVM_BALANCE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new INSUFFICIENT_EVM_BALANCE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new INSUFFICIENT_EVM_BALANCE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new PORTFOLIO_MARGIN_INVALID_ACCOUNT_KIND enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new PORTFOLIO_MARGIN_INVALID_ACCOUNT_KIND enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new PORTFOLIO_MARGIN_INVALID_ACCOUNT_KIND enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new PORTFOLIO_MARGIN_ONBOARDING_DISABLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new PORTFOLIO_MARGIN_ONBOARDING_DISABLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new PORTFOLIO_MARGIN_ONBOARDING_DISABLED enum value to the //// response property for the response status
  response-property-enum-value-added
Apr 29, 2026b83876e772af9See the full diff
- ○
  removed the BAD_STARKNET_REQUEST enum value from the //// response property for the response status
  response-property-enum-value-removed
- ○
  removed the BAD_STARKNET_REQUEST enum value from the //// response property for the response status
  response-property-enum-value-removed
- ○
  removed the BAD_STARKNET_REQUEST enum value from the //// response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_PRICE_PRECISION enum value from the //// response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_PRICE_PRECISION enum value from the //// response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_PRICE_PRECISION enum value from the //// response property for the response status
  response-property-enum-value-removed
- ○
  removed the TRANSACTION_NOT_FOUND enum value from the //// response property for the response status
  response-property-enum-value-removed
- ○
  removed the TRANSACTION_NOT_FOUND enum value from the //// response property for the response status
  response-property-enum-value-removed
- ○
  removed the TRANSACTION_NOT_FOUND enum value from the //// response property for the response status
  response-property-enum-value-removed
Apr 22, 202646a57608a7904633See the full diff
- ▲
  the response's property type changed from object to no type for status
  response-property-type-changed
- ▲
  the response's property type changed from object to no type for status
  response-property-type-changed
- ▲
  the response's property type changed from object to no type for status
  response-property-type-changed
- ▲
  the response's property type changed from object to no type for status
  response-property-type-changed
- ●
  added the new BLOCK_TRADE_ACCOUNT_MISMATCH enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_ACCOUNT_MISMATCH enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_ACCOUNT_MISMATCH enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_ALREADY_CANCELLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_ALREADY_CANCELLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_ALREADY_CANCELLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_EXPIRED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_EXPIRED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_EXPIRED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_INVALID_STATUS enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_INVALID_STATUS enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_INVALID_STATUS enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_MISSING_SIGNATURE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_MISSING_SIGNATURE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_MISSING_SIGNATURE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_MISSING_SIGNERS enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_MISSING_SIGNERS enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_MISSING_SIGNERS enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_MISSING_TRADES enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_MISSING_TRADES enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_MISSING_TRADES enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_NOT_ENABLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_NOT_ENABLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_NOT_ENABLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_NOT_FOUND enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_NOT_FOUND enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_NOT_FOUND enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_UNAUTHORIZED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_UNAUTHORIZED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_UNAUTHORIZED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new EVM_SIGNATURE_VERIFICATION_FAILED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new EVM_SIGNATURE_VERIFICATION_FAILED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new EVM_SIGNATURE_VERIFICATION_FAILED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new INVALID_EVM_SIGNATURE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new INVALID_EVM_SIGNATURE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new INVALID_EVM_SIGNATURE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new MEDIA_NOT_FOUND enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new MEDIA_NOT_FOUND enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new MEDIA_NOT_FOUND enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new OFFER_ALREADY_CANCELLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new OFFER_ALREADY_CANCELLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new OFFER_ALREADY_CANCELLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new OFFER_INVALID_STATUS enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new OFFER_INVALID_STATUS enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new OFFER_INVALID_STATUS enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new OFFER_PARENT_MISMATCH enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new OFFER_PARENT_MISMATCH enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new OFFER_PARENT_MISMATCH enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new OFFER_PARENT_NOT_ACCEPTING enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new OFFER_PARENT_NOT_ACCEPTING enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new OFFER_PARENT_NOT_ACCEPTING enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new OFFER_UNAUTHORIZED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new OFFER_UNAUTHORIZED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new OFFER_UNAUTHORIZED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new PORTFOLIO_MARGIN_CONFIG_NOT_FOUND enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new PORTFOLIO_MARGIN_CONFIG_NOT_FOUND enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new PORTFOLIO_MARGIN_CONFIG_NOT_FOUND enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new SUBKEY_NOT_ACTIVATABLE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new SUBKEY_NOT_ACTIVATABLE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new SUBKEY_NOT_ACTIVATABLE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new XP_TRANSFERS_DISABLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new XP_TRANSFERS_DISABLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new XP_TRANSFERS_DISABLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ○
  removed the INVALID_JOIN_WAITLIST_REQUEST enum value from the //// response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_JOIN_WAITLIST_REQUEST enum value from the //// response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_JOIN_WAITLIST_REQUEST enum value from the //// response property for the response status
  response-property-enum-value-removed
Dec 24, 2025846a2e2b455b14See the full diff
- ▲
  added required request body
  request-body-added-required
- ○
  added the media type application/json for the response with the status
  response-media-type-added
- ○
  added the media type application/json for the response with the status
  response-media-type-added
- ○
  added the media type application/json for the response with the status
  response-media-type-added
- ○
  added the media type application/json for the response with the status
  response-media-type-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history (12 revisions)