Skip to main content
POST
/
api
/
v1
/
streams
/
data-management
/
filters
Filter
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": {}
}'
{
  "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

OperatorDescriptionExample Value
=Equals"ethereum"
!=Not equals"pending"
>Greater than1000000
>=Greater than or equal18000000
<Less than50000
<=Less than or equal100
inValue in array or data source["ethereum", "polygon"]
existsField exists or doesn’t existtrue 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

Successful Response

​
message
string
required
​
result_id
string<uuid> | null