Verbs, Objects, and Contract Types

Filters

Filters help developers who want to look for very specific actions on-chain.

It's evidently very difficult to find clean ways to partition a blockchain that is infinitely flexible in functionality, but this will be a starting list of ways to filter - if there's any feedback or actions on-chain that you believe aren't covered, reach out to us! We'd love to hear your input.

Verbs

Start with verb when filtering; this gives broad access to any swap across all chains/exchanges, or any buy. Think of these as the first broadest filter, and if you need to get more specific, you can then combine these with contractType below to get more specific.

This is the full selection for verb:

approve
bribe
burn
buy
cancel
claim
create
deposit
donate
execute
mint
receive
sell
send
stake
swap
vest
vote
withdraw

Contract Types

Another layer of specificity, and when filtering think of these as ways to select on an actual smart contract type itself - e.g.

marketplace contracts enable the sell and buy of NFT's, not the nft contract itself.

Hence, please be careful as you're adding this second category. If you're looking for actions that the user took to sell NFT's, you should filter for:

    {
    ...
        "actions": ["sell"],
        "contractTypes": ["marketplace"]
    ...
}

This allows us to stay true to the actual infrastructure of the blockchain and enabling a lot more flexibility. We'd use the nft contract type for, say, mint actions.

This is the full selection for contractType:

community - e.g. Gitcoin, JokeDAO
derivatives - e.g. Synthetix, dYdX
exchange - e.g. Uniswap, 0x, Velodrome
lending - e.g. Aave, Compound
marketplace - e.g. OpenSea, etc.
native - e.g. ERC20
nft - e.g. Bored Ape
savings - e.g. PoolTogether
token - e.g. USDC
wallet - e.g. Gnosis Safe, Argent

Sign up now to issue an API key!