> ## 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. # Initiate a crypto deposit intent > **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. --- Initiates a crypto deposit intent for the authenticated user. Returns a wallet address to send crypto to, or triggers wallet creation if one does not exist. The user is identified from the OAuth token. ## OpenAPI ````yaml /api-reference/partners-openapi.json post /api/v1/money/deposit/crypto/intent openapi: 3.0.1 info: title: eToro Api version: v1.342.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 `), 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 - Partners security: - apiKeyAuth: [] userKeyAuth: [] - oauth2: [] tags: - name: OPS - name: KYC - name: Cash Accounts - name: FTD - name: Crypto Deposit - name: Crypto Withdrawals - name: Registration - name: Sub-Accounts - name: Email Verification - name: Trusted Partner - name: Phone Verification - name: Verification paths: /api/v1/money/deposit/crypto/intent: post: tags: - Crypto Deposit summary: Initiate a crypto deposit intent 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. --- Initiates a crypto deposit intent for the authenticated user. Returns a wallet address to send crypto to, or triggers wallet creation if one does not exist. The user is identified from the OAuth token. operationId: initiateCryptoDepositIntent parameters: - name: x-request-id in: header required: true schema: type: string format: uuid example: d66375ee-7de3-4000-8742-78a6feee2910 description: A unique request identifier. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CryptoDepositIntentRequest' example: requestReferenceId: a1b2c3d4-e5f6-7890-abcd-ef1234567890 sourceWallet: network: ETH address: '0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18' symbol: ETH amount: 1.5 responses: '200': description: Deposit intent initiated successfully content: application/json: schema: $ref: '#/components/schemas/CryptoDepositIntentApiResponse' example: success: true data: status: Success destinationAddress: '0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B' 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 `;w=`. schema: type: string example: 60;w=60 '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/CryptoPublicApi_PublicErrorResponse' example: errorCode: Unauthorized errorMessage: Unauthorized '403': description: Forbidden - Insufficient permissions content: application/json: schema: $ref: '#/components/schemas/CryptoPublicApi_PublicErrorResponse' example: errorCode: Forbidden errorMessage: Insufficient permissions '429': description: Too Many Requests content: application/json: schema: $ref: '#/components/schemas/CryptoPublicApi_PublicErrorResponse' example: errorCode: TooManyRequests errorMessage: Too many requests 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 `;w=`. schema: type: string example: 60;w=60 Retry-After: description: Seconds to wait before retrying. schema: type: integer example: 60 '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/CryptoPublicApi_PublicErrorResponse' example: errorCode: GeneralError errorMessage: Internal server error. Please retry or contact support security: - apiKeyAuth: [] userKeyAuth: [] - oauth2: - etoro-public:money.deposit.crypto:write components: schemas: CryptoDepositIntentRequest: type: object description: Request body for initiating a crypto deposit intent required: - requestReferenceId - sourceWallet - symbol - amount properties: requestReferenceId: type: string format: uuid description: Caller-generated unique reference identifier for this deposit intent example: a1b2c3d4-e5f6-7890-abcd-ef1234567890 sourceWallet: $ref: '#/components/schemas/SourceWallet' symbol: type: string description: Cryptocurrency symbol (e.g. ETH, BTC, USDC) example: ETH amount: type: number format: decimal description: Intent amount of cryptocurrency to deposit example: 1.5 CryptoDepositIntentApiResponse: type: object description: POST envelope response for a crypto deposit intent required: - success - data properties: success: type: boolean description: Whether the operation succeeded data: $ref: '#/components/schemas/CryptoDepositIntentData' CryptoPublicApi_PublicErrorResponse: type: object description: Error response with code and message required: - errorCode - errorMessage properties: errorCode: type: string description: Machine-readable error code example: GeneralError errorMessage: type: string description: Human-readable error message example: Internal server error. Please retry or contact support SourceWallet: type: object description: Source wallet identifiers for the deposit required: - network - address properties: network: type: string description: Blockchain network identifier (e.g. ETH, BTC, Polygon) example: ETH address: type: string description: The sender's external wallet address example: '0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18' CryptoDepositIntentData: type: object description: Data payload for a crypto deposit intent required: - status properties: status: type: string description: Status of the deposit intent enum: - Success - Pending - Expired - Fail example: Success destinationAddress: type: string nullable: true description: Destination wallet address to send cryptocurrency to example: '0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B' failureReason: type: string nullable: true description: >- Reason for failure when status is Fail. Only present when status is Fail. example: User not eligible symbols: type: array nullable: true items: type: string description: >- List of supported cryptocurrency symbols. Only present when status is Fail due to unsupported symbol. example: - BTC - ETH - USDC 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` x-default: 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_` x-default: >- eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_ oauth2: type: oauth2 description: >- eToro OAuth2 — send the access token as `Authorization: Bearer `. 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: '' tokenUrl: '' scopes: etoro-public:demo:read: Grants access to the 'etoro-public:demo:read' scope. etoro-public:kyc:answers:read: Grants access to the 'etoro-public:kyc:answers:read' scope. etoro-public:kyc:answers:write: Grants access to the 'etoro-public:kyc:answers:write' scope. etoro-public:kyc:questions:read: Grants access to the 'etoro-public:kyc:questions:read' scope. etoro-public:kyc:read: Grants access to the 'etoro-public:kyc:read' scope. etoro-public:kyc:regulations:read: Grants access to the 'etoro-public:kyc:regulations:read' scope. etoro-public:kyc:write: Grants access to the 'etoro-public:kyc:write' scope. etoro-public:money.accounts:read: Grants access to the 'etoro-public:money.accounts:read' scope. etoro-public:money.accounts:write: Grants access to the 'etoro-public:money.accounts:write' scope. etoro-public:money.deposit.crypto:read: >- Grants access to the 'etoro-public:money.deposit.crypto:read' scope. etoro-public:money.deposit.crypto:write: >- Grants access to the 'etoro-public:money.deposit.crypto:write' scope. etoro-public:money.ftd:read: Grants access to the 'etoro-public:money.ftd:read' scope. etoro-public:money.ftd:write: Grants access to the 'etoro-public:money.ftd:write' scope. etoro-public:money.withdraw.crypto:read: >- Grants access to the 'etoro-public:money.withdraw.crypto:read' scope. etoro-public:money.withdraw.crypto:write: >- Grants access to the 'etoro-public:money.withdraw.crypto:write' scope. etoro-public:partner-default: Grants access to the 'etoro-public:partner-default' scope. etoro-public:partner:registration:read: >- Grants access to the 'etoro-public:partner:registration:read' scope. etoro-public:partner:registration:write: >- Grants access to the 'etoro-public:partner:registration:write' scope. etoro-public:real:read: Grants access to the 'etoro-public:real:read' scope. etoro-public:sub-accounts:delete: Grants access to the 'etoro-public:sub-accounts:delete' scope. etoro-public:verification.address:read: >- Grants access to the 'etoro-public:verification.address:read' scope. etoro-public:verification.address:write: >- Grants access to the 'etoro-public:verification.address:write' scope. etoro-public:verification.email:write: >- Grants access to the 'etoro-public:verification.email:write' scope. etoro-public:verification.personaldetails:read: >- Grants access to the 'etoro-public:verification.personaldetails:read' scope. etoro-public:verification.personaldetails:write: >- Grants access to the 'etoro-public:verification.personaldetails:write' scope. etoro-public:verification.phone:write: >- Grants access to the 'etoro-public:verification.phone:write' scope. etoro-public:verification.trusted.email:write: >- Grants access to the 'etoro-public:verification.trusted.email:write' scope. etoro-public:verification.trusted.phone:write: >- Grants access to the 'etoro-public:verification.trusted.phone:write' scope. etoro-public:verification:trusted:user:write: >- Grants access to the 'etoro-public:verification:trusted:user:write' scope. ````