eToro · Schema

CreateAgentPortfolioUserTokenItem

Social TradingCopy TradingInvestingMarket DataPortfolio ManagementFintechTradingStocksCryptocurrencyETFs

Properties

Name	Type	Description
userTokenId	string	The unique identifier of the newly created user token.
userToken	string	The generated user token secret. Only available at creation time.
userTokenName	string	The user-defined name for the user token.
clientId	string	The OAuth client identifier associated with the user token.
ipsWhitelist	array	The set of whitelisted IP addresses authorized to use this token.
scopeIds	array	[DEPRECATED — use scopeNames instead] The set of permission scope identifiers granted to this token. Available scopes: 200 = etoro-public:real:read, 201 = etoro-public:demo:read, 202 = etoro-public:re
scopeNames	array	The set of permission scope names (preferred; replaces the deprecated scopeIds). Provide either scopeNames or scopeIds. Available scopes: etoro-public:real:read, etoro-public:demo:read, etoro-public:r
expiresAt	string	The expiration date and time of the user token in UTC.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/etoro/refs/heads/main/json-schema/CreateAgentPortfolioUserTokenItem.json",
  "title": "CreateAgentPortfolioUserTokenItem",
  "type": "object",
  "properties": {
    "userTokenId": {
      "type": "string",
      "format": "uuid",
      "description": "The unique identifier of the newly created user token.",
      "example": "f9e8d7c6-b5a4-3210-fedc-ba9876543210"
    },
    "userToken": {
      "type": "string",
      "description": "The generated user token secret. Only available at creation time.",
      "example": "sk_live_a1b2c3d4e5f6..."
    },
    "userTokenName": {
      "type": "string",
      "description": "The user-defined name for the user token.",
      "example": "my-trading-token"
    },
    "clientId": {
      "type": "string",
      "format": "uuid",
      "description": "The OAuth client identifier associated with the user token.",
      "example": "c1d2e3f4-a5b6-7890-cdef-123456789abc"
    },
    "ipsWhitelist": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The set of whitelisted IP addresses authorized to use this token.",
      "example": [
        "192.168.1.1"
      ]
    },
    "scopeIds": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "deprecated": true,
      "description": "[DEPRECATED \u2014 use scopeNames instead] The set of permission scope identifiers granted to this token. Available scopes: 200 = etoro-public:real:read, 201 = etoro-public:demo:read, 202 = etoro-public:real:write, 203 = etoro-public:demo:write.",
      "example": [
        211,
        212
      ]
    },
    "scopeNames": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The set of permission scope names (preferred; replaces the deprecated scopeIds). Provide either scopeNames or scopeIds. Available scopes: etoro-public:real:read, etoro-public:demo:read, etoro-public:real:write, etoro-public:demo:write.",
      "example": [
        "etoro-public:trade.real:read",
        "etoro-public:trade.real:write"
      ]
    },
    "expiresAt": {
      "type": "string",
      "format": "date-time",
      "description": "The expiration date and time of the user token in UTC.",
      "example": "2026-12-31T23:59:59Z"
    }
  }
}