Skip to main content
POST
https://api.kanarie.xyz
/
api
/
v1
/
projects
/
filter
curl --request POST \
  --url https://api.kanarie.xyz/api/v1/projects/filter \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "filter_mode": "direct"
}
'
{
  "success": true,
  "error": null,
  "projects": [
    {
      "project_id": 1,
      "project_name": "Jupiter",
      "symbol": "JUP",
      "market_cap": 1200000000
    }
  ],
  "metadata": {
    "filter_mode": "direct",
    "total_results": 1,
    "limit": 20
  }
}

Authorizations

​
Authorization
string
header
default:YOUR_KANARIE_API_KEY
required

Preferred Kanarie API key authentication using Authorization: Bearer .

Body

application/json
​
filter_mode
enum<string>
required
Available options:
natural_language,
direct
​
instructions
string

Required when filter_mode is natural_language.

Minimum string length: 10
​
sort_by
enum<string>
Available options:
trending,
market_cap,
price_change,
traders,
traders_change,
volume,
volume_change,
buy_volume_ratio,
quant_score,
quant_score_change,
mentions_24h,
mentions_7d,
mentions_change_24h,
mentions_change_7d
​
sort_direction
enum<string>
Available options:
asc,
desc
​
timeframe
enum<string>
Available options:
4h,
24h
​
tradable_chains
enum<string>[]
Available options:
solana,
ethereum,
base,
arbitrum
​
min_market_cap
number

Minimum market cap in millions.

Required range: x >= 0
​
max_market_cap
number

Maximum market cap in millions.

Required range: x >= 0
​
min_price_change
number
​
max_price_change
number
​
min_liquidity
number
Required range: x >= 0
​
min_volume
number
Required range: x >= 0
​
min_trader_count
number
Required range: x >= 0
​
min_trader_change
number
​
min_technical_score
number
Required range: -100 <= x <= 100
​
max_technical_score
number
Required range: -100 <= x <= 100
​
min_rsi
number
Required range: 0 <= x <= 100
​
max_rsi
number
Required range: 0 <= x <= 100
​
limit
integer
default:20
Required range: 1 <= x <= 50
​
page
integer
default:0
Required range: x >= 0
​
include_attributes
enum<string>[]
Available options:
developments,
recent_content,
technical_analysis,
market_data,
mindshare,
detailed_description,
metadata
​
developments_limit
integer
default:3
Required range: 1 <= x <= 10
​
recent_content_limit
integer
default:10
Required range: 1 <= x <= 25
​
recent_content_days_back
integer
default:7
Required range: 1 <= x <= 30
​
ecosystems
string[]
Maximum array length: 5
​
categories
string[]
Maximum array length: 5

Response

Filtered project results.

​
success
boolean
required
​
projects
object[]
required
​
error
string | null
​
metadata
object