blocksearch.dev

{
  "input": {
    "discoverable": true,
    "method": "GET",
    "queryParams": {
      "base": {
        "description": "Filter by specific entity or address. For example: \"0x123abc\" or \"binance\". For entity, use the entity ID.",
        "type": "string"
      },
      "chains": {
        "description": "Comma-separated list of chains. For example: \"ethereum,bsc\".",
        "type": "string"
      },
      "counterparties": {
        "description": "Comma-separated list of addresses or entities to treat strictly as counterparties (only base <-> counterparty transfers).",
        "type": "string"
      },
      "flow": {
        "description": "Transfer direction: \"in\" for incoming, \"out\" for outgoing, \"self\" for self-transfers, or \"all\" for all transfers.",
        "enum": [
          "in",
          "out",
          "self",
          "all"
        ],
        "type": "string"
      },
      "from": {
        "description": "Comma-separated list of addresses, entities, or deposit services for the 'from' side. You can also use special syntax like \"type:cex\" to filter on entity types or \"deposit:binance\" to filter on deposit addresses.",
        "type": "string"
      },
      "limit": {
        "description": "Maximum number of results to return. Default: 50",
        "type": "string"
      },
      "offset": {
        "description": "Pagination offset. Default: 0",
        "type": "string"
      },
      "sortDir": {
        "description": "Sort direction: \"asc\" (ascending) or \"desc\" (descending).",
        "enum": [
          "asc",
          "desc"
        ],
        "type": "string"
      },
      "sortKey": {
        "description": "Sort key for ordering results. One of: \"time\", \"value\", \"usd\".",
        "enum": [
          "time",
          "value",
          "usd"
        ],
        "type": "string"
      },
      "timeGte": {
        "description": "Time range filter (from) in milliseconds (e.g. 1696630274000).",
        "type": "string"
      },
      "timeLast": {
        "description": "Time range filter using relative durations. For example: \"24h\" for transfers in the last 24 hours, \"7d\" for last 7 days.",
        "type": "string"
      },
      "timeLte": {
        "description": "Time range filter (to) in milliseconds (e.g. 1696716674000).",
        "type": "string"
      },
      "to": {
        "description": "Comma-separated list of addresses, entities, or deposit services for the 'to' side.",
        "type": "string"
      },
      "tokens": {
        "description": "Comma-separated list of token addresses or token IDs. E.g. \"ethereum\", \"usd-coin\", or \"0x...tokenAddress\".",
        "type": "string"
      },
      "usdGte": {
        "description": "Minimum historical USD value.",
        "type": "number"
      },
      "usdLte": {
        "description": "Maximum historical USD value.",
        "type": "number"
      },
      "valueGte": {
        "description": "Minimum raw token value (on-chain units).",
        "type": "number"
      },
      "valueLte": {
        "description": "Maximum raw token value (on-chain units).",
        "type": "number"
      }
    },
    "type": "http"
  }
}