---
title: "Slurp Api services"
method: GET
path: "/slurp"
tags: ["Other"]
---

# Slurp Api services

`GET /slurp`

Fetch data from Etherscan and other APIs for any address. Corresponds to the <a href="/chifra/other/#chifra-slurp">chifra slurp</a> command line.

## Query parameters

- `addrs` string[], required
- `blocks` string[]
- `parts` string[]
- `appearances` boolean
- `articulate` boolean
- `source` 'etherscan' | 'covalent' | 'alchemy'
- `count` boolean
- `page` number
- `pageId` string
- `perPage` number
- `sleep` number
- `chain` string
- `noHeader` boolean
- `cache` boolean
- `decache` boolean
- `ether` boolean
- `fmt` string

## Response `200`

returns the requested data

- object
  - `data` union[] — Produces <a href="/data-model/accounts/#appearance">Appearance</a>, <a href="/data-model/other/#function">Function</a>, <a href="/data-model/accounts/#monitor">Monitor</a>, <a href="/data-model/other/#parameter">Parameter</a> or <a href="/data-model/other/#slurp">Slurp</a> data. Corresponds to the <a href="/chifra/other/#chifra-slurp">chifra slurp</a> command line.
    - union
      - Appearance — an appearance (`<blockNumber,transactionIndex>`) of an address anywhere on the chain (note that in some cases, not all fields will appear depending on the command)
        - `address` string, address — the address of the appearance
        - `blockNumber` number — the number of the block
        - `transactionIndex` number — the index of the transaction in the block
        - `traceIndex` number — the zero-based index of the trace in the transaction
        - `reason` string, string — the location in the data where the appearance was found
        - `timestamp` number — the timestamp for this appearance
        - `date` string, datetime — the timestamp as a date (calculated)
      - Function — a human-readable representation of a Solidity function call or event
        - `name` string, string — the name of the interface
        - `type` string, string — the type of the interface, either 'event' or 'function'
        - `signature` string, string — the canonical signature of the interface
        - `encoding` string, string — the signature encoded with keccak
        - `inputs` Parameter[] — the input parameters to the function, if any
          - `type` string, string — the type of this parameter
          - `name` string, string — the name of this parameter
          - `strDefault` string, string — the default value of this parameter, if any
          - `indexed` boolean — `true` if this parameter is indexed
          - `internalType` string, string — for composite types, the internal type of the parameter
          - `components` Parameter[] — for composite types, the parameters making up the composite
        - `outputs` Parameter[] — the output parameters to the function, if any
          - `type` string, string — the type of this parameter
          - `name` string, string — the name of this parameter
          - `strDefault` string, string — the default value of this parameter, if any
          - `indexed` boolean — `true` if this parameter is indexed
          - `internalType` string, string — for composite types, the internal type of the parameter
          - `components` Parameter[] — for composite types, the parameters making up the composite
      - Monitor — a local file indicating a user's interest in an address. Includes caches for reconicilations, transactions, and appearances as well as an optional association to named account
        - `address` string, address — the address of this monitor
        - `name` string, string — the name of this monitor (if any)
        - `nRecords` number — the number of appearances for this monitor
        - `fileSize` number — the size of this monitor on disc
        - `lastScanned` number — the last scanned block number
        - `isEmpty` boolean — `true` if the monitor has no appearances, `false` otherwise
        - `isStaged` boolean — `true` if the monitor file in on the stage, `false` otherwise
        - `deleted` boolean — `true` if this monitor has been deleted, `false` otherwise
      - Parameter — an input or output parameter to a Solidity function or event
        - `type` string, string — the type of this parameter
        - `name` string, string — the name of this parameter
        - `strDefault` string, string — the default value of this parameter, if any
        - `indexed` boolean — `true` if this parameter is indexed
        - `internalType` string, string — for composite types, the internal type of the parameter
        - `components` Parameter[] — for composite types, the parameters making up the composite
      - Slurp — transaction data as returned from by remote APIs
        - `hash` string, hash — the hash of the transaction
        - `blockHash` string, hash — the hash of the block containing this transaction
        - `blockNumber` number — the number of the block
        - `transactionIndex` number — the zero-indexed position of the transaction in the block
        - `nonce` number — sequence number of the transactions sent by the sender
        - `timestamp` number — the Unix timestamp of the object
        - `date` string, datetime — the timestamp as a date (calculated)
        - `from` string, address — address from which the transaction was sent
        - `to` string, address — address to which the transaction was sent
        - `value` string, wei — the amount of wei sent with this transactions
        - `ether` string, ether — if --ether is specified, the value in ether (calculated)
        - `gas` number — the maximum number of gas allowed for this transaction
        - `gasPrice` number — the number of wei per unit of gas the sender is willing to spend
        - `input` string, bytes — byte data either containing a message or funcational data for a smart contracts. See the --articulate
        - `hasToken` boolean — `true` if the transaction is token related, `false` otherwise
        - `articulatedTx` object — if present, the function that was called in the transaction
        - `compressedTx` string, string — truncated, more readable version of the articulation (calculated)
        - `isError` boolean — `true` if the transaction ended in error, `false` otherwise

## Other responses

- `400` — bad input parameter

## Changes

- **2025-02-01** `93edc250a653` — 1 breaking
  - removed the enum value `key` from the `query` request parameter `source`
- **2024-12-17** `2428f6f19a07` — 3 info
  - added the optional property `data/items/oneOf[#/components/schemas/monitor]/isEmpty` to the response with the `200` status
  - added the optional property `data/items/oneOf[#/components/schemas/monitor]/isStaged` to the response with the `200` status
  - added the optional property `data/items/oneOf[#/components/schemas/monitor]/name` to the response with the `200` status
- **2024-05-31** `2ea7591aab3e` — 1 warning, 4 info
  - deleted the `query` request parameter `types`
  - added the new optional `query` request parameter `page`
  - added the new optional `query` request parameter `pageId`
  - added the new optional `query` request parameter `parts`
  - …1 more
- **2024-05-23** `dc48e08fde74` — 1 warning, 1 info
  - deleted the `query` request parameter `raw`
  - removed `#/components/schemas/slurpCount` from the `data/items/` response property `oneOf` list for the response status `200`
- **2024-05-13** `62046cd992aa` — 1 breaking
  - the `data/items/oneOf[#/components/schemas/slurp]/nonce` response's property type/format changed from `number`/`nonce` to `number`/`value` for status `200`

[Full history](https://skmtc.dev/trueblocks/apis/trueblocks-api/changes/slurp/get.md)

---

[API](https://skmtc.dev/trueblocks/apis/trueblocks-api.md) · [All operations](https://skmtc.dev/trueblocks/apis/trueblocks-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/trueblocks/trueblocks-api/revisions/2a176f1485a9/schema)