BullAware API
Last updated
Last updated
BullAware API docs gives you access to the APIs that power BullAware.com
Before starting, you need to get an API Key from here.
You can use your API Key either on the query strings or headers:
Add ?apikey={YOUR_API_KEY}
to any API endpoint.
Add the header Authorization
with the value Bearer {YOUR_API_KEY}
You can find BullAware's OpenAPI specs here.
Returns a paginated list of investors.
Filter by username. Accepts multiple username separated by commas.
Filter for yearly returns. Years are in 4 digits format. Format: year:comparator:value. Comparators: gt, lt, gte, lte. Supports aggregate functions avg and sum for multiple years, e.g., avg(year1,year2):comparator:value.
2023:gt:5,2022:lt:10,2021:gte:2,avg(2020,2021,2022):gt:5,sum(2021,2022):gt:10
A string representing investment sectors or types, with conditions and exclusions. Use "+" for AND, "|" for OR, and "-" for NOT. For example, "Tech+Software-Crypto" means Tech AND Software, but NO Crypto. Valid sectors/types: Tech, Manufacturing, Med Tech, Retail, Financial Services, Energy, Consumable Goods, Healthcare, Media Services, Construction, Utilities, Minerals, Software, Entertainment, Durable Goods, Telecom, Processing, Distribution, Other, Stocks, Transportation, Currencies, Commodities, Indices, ETF, Crypto.
Filter by country (ISO 3166-1 alpha-2 country code). Accepts multiple countries separated by commas.
US,GB
Sorts results by a field or aggregate expressions. Format for field sort: 'fieldName:order' (e.g., 'return1Year:asc', default is 'desc'). For aggregates like sum or avg, use 'operation(field1,field2):order' (e.g., 'sum(yearlyReturns.2023,yearlyReturns.2022)' or 'avg(yearlyReturns.2023,yearlyReturns.2022,yearlyReturns.2021):asc').
Page number for pagination (default: 1).
1
Filter for weeks since registration. Comparators: gt, lt, gte, lte.
lte:50
Filter for the maximum weekly drawdown during the last 12 months. It's a negative number between 0 and -100. Closest to -100 mean higher losses. Comparators: gt, lt, gte, lte.
gt:-5
Filter for the maximum daily drawdown during the last 12 months. It's a negative number between 0 and -100. Closest to -100 mean higher losses. Comparators: gt, lt, gte, lte.
gt:-3
Filter for the percentage of trades that were profitable during the last 12 months. Comparators: gt, lt, gte, lte.
gte:50
Filter for number of trades during the last 12 months. Comparators: gt, lt, gte, lte.
gte:50
Filter for copiers. Comparators: gt, lt, gte, lte.
gt:100
Filter for return over 2 years. Comparators: gt, lt, gte, lte.
gt:20
Filter for return this year. Comparators: gt, lt, gte, lte.
gte:10
Filter for return this week. Comparators: gt, lt, gte, lte.
gt:2
eToro username
Start date for trades in ISO format. If not provided, it will use the first trade date.
End date for trades in ISO format. If not provided, it will use the latest trade date.
eToro username
Start date for trades in ISO format. If not provided, it will use the first trade date.
End date for trades in ISO format. If not provided, it will use the latest trade date.
Returns a paginated list of instruments.
Filter by symbol. Accepts multiple symbols separated by commas.
Filter by sector. Accepts multiple sectors separated by commas.
Filter by industry. Accepts multiple industries separated by commas.
Filter by index. Accepts multiple indices separated by commas.
Filter by country (ISO 3166-1 alpha-2 country code). Accepts multiple countries separated by commas.
US,GB
Filter for yearly returns. Years are in 4 digits format. Format: year:comparator:value. Comparators: gt, lt, gte, lte. Supports aggregate functions avg and sum for multiple years, e.g., avg(year1,year2):comparator:value.
2023:gt:5,2022:lt:10,2021:gte:2,avg(2020,2021,2022):gt:5,sum(2021,2022):gt:10
Sorts results by a field or aggregate expressions. Format for field sort: 'fieldName:order' (e.g., 'returnYearToDate:asc', default is 'desc'). For aggregates like sum or avg, use 'operation(field1,field2):order' (e.g., 'sum(yearlyReturns.2023,yearlyReturns.2022)' or 'avg(operatingMargin,grossIncomeMargin):asc')').
Comma-separated list of fields to include in the response.
Page number for pagination (default: 1).
1
Filter by average net profit margin. Comparators: gt, lt, gte, lte.
gt:20
Filter by the average return on investment. Comparators: gt, lt, gte, lte.
gt:15
Filter by gross income margin. Comparators: gt, lt, gte, lte.
gte:40
Filter by operating margin. Comparators: gt, lt, gte, lte.
gte:15
Filter by quick ratio. Comparators: gt, lt, gte, lte.
gte:1.5
Filter by total debt to equity ratio. Comparators: gt, lt, gte, lte.
lt:0.5
Filter by beta. Comparators: gt, lt, gte, lte.
gt:1
Filter by current ratio. Comparators: gt, lt, gte, lte.
gte:1
Filter by P/E ratio. Comparators: gt, lt, gte, lte.
lte:25
Filter by dividend payout ratio. Comparators: gt, lt, gte, lte.
gt:5
Filter by dividend yield percentage. Comparators: gt, lt, gte, lte.
gt:5
Filter by dividend per share during the last 12 months. Comparators: gt, lt, gte, lte.
gt:1
Filter by sales or revenue in dollars. Comparators: gt, lt, gte, lte.
gt:1000000
Filter by earnings per share. Comparators: gt, lt, gte, lte.
gt:1
Filter by market cap in dollars. Comparators: gt, lt, gte, lte.
gte:100000000
Filter by number of employees. Comparators: gt, lt, gte, lte.
gte:1000
Filter by the return year to date. Comparators: gt, lt, gte, lte.
gt:15
Filter by the return during the last year. Comparators: gt, lt, gte, lte.
gt:30
Filter by the return during the last month. Comparators: gt, lt, gte, lte.
gt:6
A unique identifier for the ranking set or criteria.
Page number for pagination.
Number of results per page.
Filter results by eToro username.
Filter results by country code.
Filter by strategy type. Enter the number for the desired strategy: Value = 1, Growth = 2, Income = 3, LongShort = 4, MultiStrategy = 5, Momentum = 6, Macro = 7, MarketNeutral = 8, EventDriven = 9, DiversifiedETF = 10, Quant = 11.
Minimum BullAware score.
Maximum BullAware score.
Minimum Sharpe ratio.
Maximum Sharpe ratio.
Minimum beta.
Maximum beta.
Minimum annualized return percentage.
Maximum annualized return percentage.
Minimum eToro risk score.
Maximum eToro risk score.
Minimum track record length (in years).
Maximum track record length (in years).
Minimum number of copiers.
Maximum number of copiers.
Minimum PI level.
Maximum Pi level.
Minimum number of trades.
Maximum number of trades.
Minimum percentage of green (profitable) months.
Maximum percentage of green (profitable) months.
Minimum percentage of green (profitable) years.
Maximum percentage of green (profitable) years.
Minimum win ratio (percentage of winning trades).
Maximum win ratio (percentage of winning trades).
Maximum drawdown depth.
Maximum drawdown duration filter (in months).
Minimum dividend yield.
Maximum dividend yield.
Minimum number of currently open instruments.
Maximum number of currently open instruments.
Minimum percentage of long positions.
Maximum percentage of long positions.
Minimum percentage of positions with no leverage.
Maximum percentage of positions with no leverage.
Comma-separated list of sectors the investor must be investing in.
Comma-separated list of sectors the investor must NOT be investing in.