Skip to main content
GET
/
explore
/
contracts
Explore contracts with Boosts
curl --request GET \
  --url https://api-v2.boost.xyz/explore/contracts
[
  {
    "chainId": 8453,
    "address": "0x378632819f39c74c4f56b1429e760739c5fb51b7",
    "name": "Zora",
    "stats": {
      "boostCount": 123,
      "totalClaims": 123,
      "totalAmountClaimedUsd": 123
    }
  }
]

Query Parameters

​
page
integer | null
default:1

The desired page to return from the query

Required range: x >= 0
​
pageSize
integer | null
default:10

The amount of items to return from the query, defaults to 10, and must be <= 100

Required range: 0 <= x <= 100
​
sortBy
enum<string>
required

Sort by most total completions, total budget, or recent Boost creations

Available options:
most-completions,
total-spend,
recently-deployed
Example:

"most-completions"

​
timePeriod
enum<string>
default:7d

The time range to filter by

Available options:
6h,
24h,
7d
Example:

"7d"

​
actionChainIds
any

A comma separated list of chain IDs for Boost actions to filter by

Example:

"8453,10"

​
userAddress
string

Filter by Boosts created by a specific user address

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x378632819f39c74c4f56b1429e760739c5fb51b7"

Response

200 - application/json

Returns a list of smart contracts known to the Boost system

​
chainId
number
required

The chain ID of the smart contract

Example:

8453

​
address
string
required

The address of the smart contract

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x378632819f39c74c4f56b1429e760739c5fb51b7"

​
name
string
required

A human readable name for the smart contract

Example:

"Zora"

​
stats
object
required