> ## Documentation Index
> Fetch the complete documentation index at: https://api-portal.etoro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Stockback Payments

> **Rate limit:** 60 requests per 60 seconds. This is the **default shared quota** — it is shared with every other endpoint that has no dedicated limit, so requests across those endpoints all draw from the same budget.

---

Retrieves information about the rewards given to the calling user as part of the 4% Card Promo stock-back promotion. The data is returned as a list of individual reward events, each with the date the reward was given, the stock name, and the amount in USD.

Rewards fall into two types:
- **Stock reward (airdrop)** — stock deposited directly into the user's account
- **Cash reward** — paid when the user is unable to receive a stock airdrop, or in case the user is a Popular Investor (PI)

This is user-scoped: the caller is identified by their own gateway-issued GCID, not a path or query parameter, so it always answers for 'me'. Results are returned under `results` with a `pagination` block; a customer with no payments returns 200 with an empty `results` array, not 404.



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/data/stockback/payments
openapi: 3.0.1
info:
  title: etoro Api
  version: v1.417.0
  description: >-
    etoro’s public API provides access to real-time financial data, trading
    insights, and account management features, allowing developers to integrate
    etoro’s services into their applications. With access to market prices,
    historical data, and social trading information, the API empowers users to
    enhance their trading strategies. Designed for security and scalability, the
    etoro API ensures smooth and reliable integration for a variety of financial
    applications.


    For more details on integrating with etoro's public WebSocket service,
    please refer to the dedicated [WebSocket
    documentation](./websocket/websocket-doc.html).


    ## Authentication


    Every request must be authenticated with exactly one of two options: an
    OAuth 2.0 access token (`Authorization: Bearer <token>`), or the
    non-interactive credential pair (`x-api-key` + `x-user-key` headers). The
    two options are mutually exclusive — a request carrying both is rejected.
    Each operation lists the OAuth scopes that grant access as alternative
    security requirements: a bearer token needs only ONE of them, and the same
    permissions govern the credential pair.
servers:
  - url: https://public-api.etoro.com
    description: etoro Public API
security:
  - apiKeyAuth: []
    userKeyAuth: []
  - oauth2: []
tags:
  - name: Agent Portfolios
  - name: Balances
  - name: Clubs
  - name: Watchlists
  - name: Data
  - name: Top Assets
  - name: App Data
  - name: Market Data
  - name: Identity
  - name: Cash Accounts
  - name: Transfer
  - name: Notifications
  - name: PI Data
  - name: PortfolioSearch
  - name: Price Alerts
  - name: SSO - Applications
  - name: SSO - Scopes
  - name: Sub-Accounts - eToro Trading
  - name: Sub-Accounts
  - name: Trading - Demo
  - name: Trading - Real
  - name: Users Info
  - name: Rankings
  - name: User Stats
  - name: Copy Trading
  - name: Copy Trading - Demo
paths:
  /api/v1/data/stockback/payments:
    get:
      tags:
        - Data
      summary: Get Stockback Payments
      description: >-
        **Rate limit:** 60 requests per 60 seconds. This is the **default shared
        quota** — it is shared with every other endpoint that has no dedicated
        limit, so requests across those endpoints all draw from the same budget.


        ---


        Retrieves information about the rewards given to the calling user as
        part of the 4% Card Promo stock-back promotion. The data is returned as
        a list of individual reward events, each with the date the reward was
        given, the stock name, and the amount in USD.


        Rewards fall into two types:

        - **Stock reward (airdrop)** — stock deposited directly into the user's
        account

        - **Cash reward** — paid when the user is unable to receive a stock
        airdrop, or in case the user is a Popular Investor (PI)


        This is user-scoped: the caller is identified by their own
        gateway-issued GCID, not a path or query parameter, so it always answers
        for 'me'. Results are returned under `results` with a `pagination`
        block; a customer with no payments returns 200 with an empty `results`
        array, not 404.
      operationId: getStockbackPayments
      parameters:
        - name: x-request-id
          in: header
          required: true
          schema:
            type: string
            format: uuid
            example: 3743b012-1a0e-406b-9d01-3a49f2a31cf6
          description: A unique request identifier.
          example: 3743b012-1a0e-406b-9d01-3a49f2a31cf6
        - name: page
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: 1
            default: 1
          description: 1-based page number to return.
        - name: pageSize
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: 1
            maximum: 500
            default: 50
          description: Items per page. Defaults to 50, maximum 500.
      responses:
        '200':
          description: >-
            One page of the caller's stockback payments, newest payment date
            first.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StockbackPaymentsPage'
              example:
                results:
                  - channel: stockback
                    paidUsd: 12.5
                    stockName: AAPL
                    positionId: 9001
                    sourceTxId: tx-1
                    txLabel: Stockback reward
                    paymentDate: '2026-10-01'
                    eom: '2026-10-31'
                  - channel: cashback
                    paidUsd: 3
                    stockName: null
                    positionId: null
                    sourceTxId: null
                    txLabel: null
                    paymentDate: '2026-09-01'
                    eom: '2026-09-30'
                pagination:
                  page: 1
                  pageSize: 50
                  hasNext: false
          headers:
            X-Correlation-Id:
              schema:
                type: string
                format: uuid
              description: >-
                Correlation id for this call, generated by the data platform
                upstream when the request arrives without one and identical end
                to end. Quote it to etoro support to find the request in logs.
            X-Request-Id:
              schema:
                type: string
                format: uuid
              description: >-
                Echoed back only when the caller supplied it. The upstream never
                generates one.
            X-Timestamp:
              schema:
                type: string
                format: date-time
              description: RFC 3339 instant the response was produced.
            Cache-Control:
              schema:
                type: string
              description: Always `private, no-store` -- this is customer-scoped data.
              example: private, no-store
            RateLimit-Limit:
              description: >-
                Maximum number of requests allowed per window. This is the
                default shared pool used by every endpoint without a dedicated
                limit, so it is NOT per-endpoint — requests across those
                endpoints all draw from this one budget.
              schema:
                type: integer
              example: 60
            RateLimit-Remaining:
              description: Requests remaining in the current window for this quota.
              schema:
                type: integer
            RateLimit-Reset:
              description: Seconds until the current window resets.
              schema:
                type: integer
            RateLimit-Policy:
              description: Quota policy in the form `<limit>;w=<window-seconds>`.
              schema:
                type: string
              example: 60;w=60
        '400':
          description: The page or pageSize query parameter is out of range.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataApiError'
              example:
                success: false
                error:
                  code: INVALID_REQUEST
                  message: The request is invalid
          headers:
            X-Correlation-Id:
              schema:
                type: string
                format: uuid
              description: >-
                Correlation id for this call, generated by the data platform
                upstream when the request arrives without one and identical end
                to end. Quote it to etoro support to find the request in logs.
            X-Request-Id:
              schema:
                type: string
                format: uuid
              description: >-
                Echoed back only when the caller supplied it. The upstream never
                generates one.
            X-Timestamp:
              schema:
                type: string
                format: date-time
              description: RFC 3339 instant the response was produced.
            Cache-Control:
              schema:
                type: string
              description: Always `private, no-store` -- this is customer-scoped data.
              example: private, no-store
        '401':
          description: The gateway did not inject a GCID for this request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataApiError'
              example:
                success: false
                error:
                  code: GCID_REQUIRED
                  message: This endpoint requires a gateway-issued GCID
          headers:
            X-Correlation-Id:
              schema:
                type: string
                format: uuid
              description: >-
                Correlation id for this call, generated by the data platform
                upstream when the request arrives without one and identical end
                to end. Quote it to etoro support to find the request in logs.
            X-Request-Id:
              schema:
                type: string
                format: uuid
              description: >-
                Echoed back only when the caller supplied it. The upstream never
                generates one.
            X-Timestamp:
              schema:
                type: string
                format: date-time
              description: RFC 3339 instant the response was produced.
            Cache-Control:
              schema:
                type: string
              description: Always `private, no-store` -- this is customer-scoped data.
              example: private, no-store
        '429':
          description: >-
            Too Many Requests — the shared rate limit (60 requests / 60s) was
            exceeded.
          headers:
            RateLimit-Limit:
              description: >-
                Maximum number of requests allowed per window. This is the
                default shared pool used by every endpoint without a dedicated
                limit, so it is NOT per-endpoint — requests across those
                endpoints all draw from this one budget.
              schema:
                type: integer
              example: 60
            RateLimit-Remaining:
              description: Requests remaining in the current window for this quota.
              schema:
                type: integer
            RateLimit-Reset:
              description: Seconds until the current window resets.
              schema:
                type: integer
            RateLimit-Policy:
              description: Quota policy in the form `<limit>;w=<window-seconds>`.
              schema:
                type: string
              example: 60;w=60
            Retry-After:
              description: Seconds to wait before retrying.
              schema:
                type: integer
              example: 60
        '503':
          description: >-
            The serving dependency is temporarily unavailable; the upstream
            already retried with backoff before returning this. Safe to retry.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataApiError'
              example:
                success: false
                error:
                  code: DEPENDENCY_UNAVAILABLE
                  message: The requested resource is temporarily unavailable
          headers:
            X-Correlation-Id:
              schema:
                type: string
                format: uuid
              description: >-
                Correlation id for this call, generated by the data platform
                upstream when the request arrives without one and identical end
                to end. Quote it to etoro support to find the request in logs.
            X-Request-Id:
              schema:
                type: string
                format: uuid
              description: >-
                Echoed back only when the caller supplied it. The upstream never
                generates one.
            X-Timestamp:
              schema:
                type: string
                format: date-time
              description: RFC 3339 instant the response was produced.
            Cache-Control:
              schema:
                type: string
              description: Always `private, no-store` -- this is customer-scoped data.
              example: private, no-store
      security:
        - apiKeyAuth: []
          userKeyAuth: []
        - oauth2:
            - etoro-public:real:read
        - oauth2:
            - etoro-public:demo:read
        - oauth2:
            - etoro-public:trade.real:read
        - oauth2:
            - etoro-public:trade.demo:read
components:
  schemas:
    StockbackPaymentsPage:
      type: object
      description: >-
        One page of the caller's stockback payments. The collection is a
        property of this object rather than a bare top-level array, so further
        fields can be added without a breaking change.
      properties:
        results:
          type: array
          description: Payments for this page, newest payment date first.
          items:
            $ref: '#/components/schemas/StockbackPayment'
        pagination:
          $ref: '#/components/schemas/Pagination'
      required:
        - results
        - pagination
    DataApiError:
      type: object
      description: >-
        Error envelope returned by the data platform upstream. Response metadata
        is not in the body: the correlation id, the request id and the timestamp
        are returned as the `X-Correlation-Id`, `X-Request-Id` and `X-Timestamp`
        response headers. Quote `X-Correlation-Id` to etoro support to find the
        request in logs.
      properties:
        success:
          type: boolean
          description: Always false on an error response.
          example: false
        error:
          type: object
          properties:
            code:
              type: string
              description: Stable machine-readable error code, UPPER_SNAKE_CASE.
            message:
              type: string
              description: >-
                Human-readable description. Not intended for display to end
                users.
          required:
            - code
            - message
      required:
        - success
        - error
    StockbackPayment:
      type: object
      description: >-
        One stockback or cashback payment made to the caller. Every field is
        nullable: a payment may have no related position or source transaction.
      properties:
        channel:
          type: string
          nullable: true
          description: The reward channel the payment was made through.
          example: stockback
        paidUsd:
          type: number
          format: double
          nullable: true
          description: Amount paid, in USD.
          example: 12.5
        stockName:
          type: string
          nullable: true
          description: Name of the stock the payment relates to, if any.
          example: AAPL
        positionId:
          type: integer
          format: int64
          nullable: true
          description: >-
            Identifier of the trading position the payment relates to. Null when
            the payment is not tied to a position.
          example: 9001
        sourceTxId:
          type: string
          nullable: true
          description: >-
            Identifier of the source transaction the payment originates from.
            Null when there is none.
          example: tx-1
        txLabel:
          type: string
          nullable: true
          description: Label describing the payment transaction.
          example: Stockback reward
        paymentDate:
          type: string
          format: date
          nullable: true
          description: Date the payment was made.
          example: '2026-10-01'
        eom:
          type: string
          format: date
          nullable: true
          description: End of the month the payment belongs to.
          example: '2026-10-31'
    Pagination:
      type: object
      description: Offset pagination metadata for a collection response.
      properties:
        page:
          type: integer
          format: int32
          description: 1-based index of the page returned.
          example: 1
        pageSize:
          type: integer
          format: int32
          description: Maximum number of items that could be returned on this page.
          example: 50
        hasNext:
          type: boolean
          description: Whether a further page exists after this one.
          example: false
      required:
        - page
        - pageSize
        - hasNext
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        API key of the application. Only valid together with the x-user-key
        header — the pair is an alternative to OAuth bearer authentication,
        never sent alongside it. The pair is granted the same permissions the
        operation's OAuth scopes describe.


        Demo credential for trying the API from these docs:
        `lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663`
    userKeyAuth:
      type: apiKey
      in: header
      name: x-user-key
      description: >-
        User-specific authentication key. Only valid together with the x-api-key
        header — the pair is an alternative to OAuth bearer authentication,
        never sent alongside it.


        Demo credential for trying the API from these docs:
        `eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_`
    oauth2:
      type: oauth2
      description: >-
        etoro OAuth2 — send the access token as `Authorization: Bearer <token>`.
        Each operation lists the scopes that grant access as separate `security`
        requirements (OpenAPI OR semantics): the caller's token only needs ONE
        of them — you do NOT need all of them. Mutually exclusive with the
        x-api-key/x-user-key credential pair: never send both.
      flows:
        authorizationCode:
          authorizationUrl: https://www.etoro.com/sso
          tokenUrl: https://www.etoro.com/api/sso/v1/token
          scopes:
            etoro-public:agent-portfolio:read: Grants access to the 'etoro-public:agent-portfolio:read' scope.
            etoro-public:agent-portfolio:write: Grants access to the 'etoro-public:agent-portfolio:write' scope.
            etoro-public:club:read: Grants access to the 'etoro-public:club:read' scope.
            etoro-public:demo:read: Grants access to the 'etoro-public:demo:read' scope.
            etoro-public:demo:write: Grants access to the 'etoro-public:demo:write' scope.
            etoro-public:feed:read: Grants access to the 'etoro-public:feed:read' scope.
            etoro-public:market-data:read: Grants access to the 'etoro-public:market-data:read' scope.
            etoro-public:money.balance:read: Grants access to the 'etoro-public:money.balance:read' scope.
            etoro-public:money.cash-transactions:read: >-
              Grants access to the 'etoro-public:money.cash-transactions:read'
              scope.
            etoro-public:money.transfer:read: Grants access to the 'etoro-public:money.transfer:read' scope.
            etoro-public:money.transfer:write: Grants access to the 'etoro-public:money.transfer:write' scope.
            etoro-public:money:transfer: Grants access to the 'etoro-public:money:transfer' scope.
            etoro-public:notifications:read: Grants access to the 'etoro-public:notifications:read' scope.
            etoro-public:notifications:write: Grants access to the 'etoro-public:notifications:write' scope.
            etoro-public:pi-data:read: Grants access to the 'etoro-public:pi-data:read' scope.
            etoro-public:price-alerts:read: Grants access to the 'etoro-public:price-alerts:read' scope.
            etoro-public:price-alerts:write: Grants access to the 'etoro-public:price-alerts:write' scope.
            etoro-public:real:read: Grants access to the 'etoro-public:real:read' scope.
            etoro-public:real:write: Grants access to the 'etoro-public:real:write' scope.
            etoro-public:sso-applications:read: Grants access to the 'etoro-public:sso-applications:read' scope.
            etoro-public:sso-applications:write: Grants access to the 'etoro-public:sso-applications:write' scope.
            etoro-public:sso-scopes:read: Grants access to the 'etoro-public:sso-scopes:read' scope.
            etoro-public:sso-scopes:write: Grants access to the 'etoro-public:sso-scopes:write' scope.
            etoro-public:sub-accounts:read: Grants access to the 'etoro-public:sub-accounts:read' scope.
            etoro-public:sub-accounts:write: Grants access to the 'etoro-public:sub-accounts:write' scope.
            etoro-public:trade.demo:read: Grants access to the 'etoro-public:trade.demo:read' scope.
            etoro-public:trade.demo:write: Grants access to the 'etoro-public:trade.demo:write' scope.
            etoro-public:trade.real:read: Grants access to the 'etoro-public:trade.real:read' scope.
            etoro-public:trade.real:write: Grants access to the 'etoro-public:trade.real:write' scope.
            etoro-public:user-info:read: Grants access to the 'etoro-public:user-info:read' scope.
            etoro-public:watchlist:read: Grants access to the 'etoro-public:watchlist:read' scope.
            etoro-public:watchlist:write: Grants access to the 'etoro-public:watchlist:write' scope.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.