eToro 公共 API 📈

完整的 eToro 公共 API 集成，支持交易执行、市场数据、社交动态和自选列表。

API 文档： https://etoro-6fc30280.mintlify.app/
基础 URL： https://public-api.etoro.com/api/v1

身份验证

三种认证模式（按优先级排序）：

1. 1. SSO 访问令牌 — Authorization: Bearer token>
2. SSO 认证令牌 — Authorization: user_id>
3. API 密钥 — x-api-key + x-user-key + x-request-id（UUID）

端点

投资组合与账户

工具	方法	端点	认证
getportfolio	GET	/trading/info/portfolio（演示：/trading/info/demo/portfolio）	个人
gettrading_history

GET | /trading/info/real/history（演示：/trading/info/demo/history） | 个人 |

交易执行

所有交易端点均支持真实/演示模式。演示模式在 /execution/ 后添加 /demo/。

工具	方法	端点
openpositionbyamount	POST	/trading/execution/market-open-orders/by-amount
openpositionbyunits

POST | /trading/execution/market-open-orders/by-units | | close_position | POST | /trading/execution/market-close-orders/{positionId} | | placelimitorder | POST | /trading/execution/limit-orders | | cancellimitorder | DELETE | /trading/execution/limit-orders/{orderId} | | cancelopenorder | DELETE | /trading/execution/market-open-orders/{orderId} | | cancelcloseorder | DELETE | /trading/execution/market-close-orders/{orderId} |

市场数据（公共）

工具	方法	端点
getmarketdata	GET	/market-data/search?internalSymbolFull=AAPL
getmarketrates

GET | /market-data/rates?instrumentIds=1001,1002 |

| getpricehistory | GET | /market-data/instruments/{id}/candles?period=OneMonth | | gettradinginfo | GET | /trading/info/instrument/{id} | | getassetclasses | GET | /market-data/instrument-types | | get_exchanges | GET | /market-data/exchanges | | getinstrumentmetadata | GET | /market-data/instruments?instrumentIds=1001,1002 | | getclosingprices | GET | /market-data/closing-prices |

社交

工具	方法	端点
getinstrumentfeed	GET	/feeds/instruments/{id}?limit=5
getpopularinvestors

GET | /copy/popular-investors?limit=10 |

| search_users | GET | /users/search?query=... | | getuserportfolio | GET | /users/{username}/portfolio | | getuserstats | GET | /users/{username}/stats | | getuserfeed | GET | /feeds/users/{username}?limit=5 | | create_post | POST | /feeds/posts | | create_comment | POST | /feeds/posts/{postId}/comments |

自选列表

工具	方法	端点
getwatchlists	GET	/watchlists
getcurated_lists

GET | /watchlists/curated |

| create_watchlist | POST | /watchlists | | addtowatchlist | POST | /watchlists/{watchlistId}/items | | removefromwatchlist | DELETE | /watchlists/{watchlistId}/items/{instrumentId} |

关键说明

• - 工具 ID 为数字格式（非股票代码）。通过 /market-data/search?internalSymbolFull=AAPL 解析
• 交易工具默认使用 mode=real。仅在明确要求时使用演示模式
• 所有交易执行在发送前均记录完整的请求详情
• 速率限制：每分钟 100 次请求