Filter projects - Kanarie API

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
  }
}

{
  "error": "Validation failed",
  "details": [
    "limit must be a number between 1 and 100"
  ]
}

{
  "error": "Missing API key. Expected Authorization: Bearer <api-key> or x-kanarie-api-key: <api-key>."
}

{
  "x402Version": 2,
  "error": "Payment required",
  "accepts": [
    {}
  ]
}

{
  "error": "Invalid API key"
}

{
  "error": "Rate limit exceeded",
  "limit": 123,
  "plan": "casual",
  "window": "15 minutes",
  "retryAfter": 900
}

{
  "error": "Internal server error"
}

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
  }
}

{
  "error": "Validation failed",
  "details": [
    "limit must be a number between 1 and 100"
  ]
}

{
  "error": "Missing API key. Expected Authorization: Bearer <api-key> or x-kanarie-api-key: <api-key>."
}

{
  "x402Version": 2,
  "error": "Payment required",
  "accepts": [
    {}
  ]
}

{
  "error": "Invalid API key"
}

{
  "error": "Rate limit exceeded",
  "limit": 123,
  "plan": "casual",
  "window": "15 minutes",
  "retryAfter": 900
}

{
  "error": "Internal server error"
}

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