API Reference

Feed

get
https://feed-api.cielo.finance/api/v1/feed

This endpoint retrieves a feed of transactions based on specified query parameters. When set to true, the response will include the market capitalization of tokens, as well as liquidity swap and transfer events. Note that enabling this option will double the cost per request to 10 credits. If the query is filtered by wallet address, the cost will increase to 6 credits per request.

Filters

  • Wallet Address: Filter transactions by wallet address.
  • Number of Transactions (limit): Specify the number of transactions to retrieve.
  • Specific Lists: Filter transactions by specific lists.
  • Chains: Filter transactions by chains.
  • Transaction Types: Filter transactions by transaction types.
  • Tokens: Filter transactions by tokens.
  • Minimum USD Value: Filter transactions by minimum USD value.
  • Maximum USD Value: Filter transactions by maximum USD value.
  • Starting Point: Specify the starting point of the feed.
  • New Trades: Filter transactions by new trades.

Supported Chains

  • All EVM chains
  • Solana

Cost

  • Cost per request: 5 credits
  • When filtered by wallet address: 3 credits

Available Plans

Available on the following plans:

  • Free
  • Builder
  • Architect
  • Enterprise
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

Filter the feed by a specific wallet address.

integer

Limit the number of transactions returned in the feed. The maximum limit is 100.

integer

Filter transactions by a specific List ID.

chains
array of strings

Filter transactions by specific blockchain chains (e.g. ethereum), comma-separated for multiple values (e.g, ethereum,polygon)

chains
txTypes
array of strings

Filter transactions by types (e.g. swap, nft_trade), comma-separated for multiple values (e.g, swap,transfer,nft_trade)

txTypes
tokens
array of strings

Filter transactions by specific tokens, identified by either their address or symbol , comma-separated for multiple values (e.g, LINK,BITCOIN)

tokens
number

Set a minimum USD value for transactions. Default - 0

number

Set a maximum USD value for transactions. Default - 0

boolean

Filter transactions by new trades.

string

Set value from response 'paging.next_object_id' to get next page.

integer

Filter transactions from a specific UNIX timestamp.

integer

Filter transactions to a specific UNIX timestamp.

boolean

Include market capitalization of tokens in the response. Note that enabling this option will double the cost per request to 10 credits.

Responses

Updated about 2 months ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 2 months ago