Sign in
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)

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 season2 if not provided.

Example request

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

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 3 of the 50 revisions of this API.16

  • e0dd7ef9404f14See the full diff
    • ▲

      added required request body

      request-body-added-required

    • ○

      added the media type application/json for the response with the status 201

      response-media-type-added

    • ○

      added the media type application/json for the response with the status 400

      response-media-type-added

    • ○

      added the media type application/json for the response with the status 401

      response-media-type-added

    • ○

      added the media type application/json for the response with the status 403

      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

  • acfd4cdd07751See the full diff
    • ○

      removed the non-success response with the status 500

      response-non-success-status-removed

  • a1340269c9181See the full diff
    • ○

      endpoint added

      endpoint-added