Create filter

Create a new filter by specifying the field, operator and type

POST /api/v1/streams/data-management/filters

Filter

cURL

curl --request POST \
  --url https://api.allium.so/api/v1/streams/data-management/filters \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '{
  "filter": {}
}'

200

{
  "message": "<string>",
  "result_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

This endpoint creates a new filter for use in stream transformations.

Filters support comparison operators (=, !=, >, >=, <, <=), the in operator for matching against arrays or data sources, the exists operator for field presence checks, and compound AND/OR logic for complex conditions.

See the Filter Syntax documentation for complete details on all operators, nested conditions, and examples.

Example Filter with Data Source

{
    "filter": {
        "field": "token_address",
        "operator": "in",
        "data_source_id": "3123712-aqw1-asdg-0293-1f48914e1e3f"
    }
}

Example Filter with Array Values

{
    "filter": {
        "field": "token_address",
        "operator": "in",
        "value": [
            "0x1234567890abcdef1234567890abcdef12345678",
            "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd"
        ]
    }
}

Example Compound Filter

{
    "filter": {
        "op": "AND",
        "conditions": [
            {
                "field": "blockchain",
                "operator": "=",
                "value": "ethereum"
            },
            {
                "field": "value",
                "operator": ">",
                "value": "1000000000000000000"
            }
        ]
    }
}

Supported Operators

Operator	Description	Example Value
=	Equals	"ethereum"
!=	Not equals	"pending"
>	Greater than	1000000
>=	Greater than or equal	18000000
<	Less than	50000
<=	Less than or equal	100
in	Value in array or data source	["ethereum", "polygon"]
exists	Field exists or doesn’t exist	true or false

Old Filter Syntax (Deprecated)

The old filter syntax with "type": "data_source" and uppercase operators is deprecated. We recommend using the new syntax shown above.

{
    "filter": {
        "field": "token_address",
        "operator": "IN",
        "type": "data_source",
        "data_source_id": "3123712-aqw1-asdg-0293-1f48914e1e3f"
    }
}

Next Steps

Filter Syntax

Learn how to filter streams with complex conditions

Authorizations

X-API-KEY · string · header · required

Body

application/json

filter · Filter · object · required

Response

200

application/json

Successful Response

message · string · required

result_id · string<uuid> | null