yddkctoq.nx.link

{
  "parameters": [
    {
      "description": "A valid Ethereum address (0x-prefixed hex string) or ENS name (e.g., vitalik.eth).",
      "in": "path",
      "name": "address",
      "required": true,
      "schema": {
        "description": "A valid Ethereum address (0x-prefixed hex string) or ENS name (e.g., vitalik.eth).",
        "type": "string"
      }
    },
    {
      "description": "Filter by block timestamp (Unix timestamp) greater than or equal to this value",
      "in": "query",
      "name": "filterBlockTimestampGte",
      "required": false,
      "schema": {
        "description": "Filter by block timestamp (Unix timestamp) greater than or equal to this value",
        "minimum": 0,
        "nullable": true,
        "type": "integer"
      }
    },
    {
      "description": "Filter by block timestamp (Unix timestamp) less than or equal to this value",
      "in": "query",
      "name": "filterBlockTimestampLte",
      "required": false,
      "schema": {
        "description": "Filter by block timestamp (Unix timestamp) less than or equal to this value",
        "minimum": 0,
        "nullable": true,
        "type": "integer"
      }
    },
    {
      "description": "Filter by block number greater than or equal to this value",
      "in": "query",
      "name": "filterBlockNumberGte",
      "required": false,
      "schema": {
        "description": "Filter by block number greater than or equal to this value",
        "minimum": 0,
        "nullable": true,
        "type": "integer"
      }
    },
    {
      "description": "Filter by block number less than or equal to this value",
      "in": "query",
      "name": "filterBlockNumberLte",
      "required": false,
      "schema": {
        "description": "Filter by block number less than or equal to this value",
        "minimum": 0,
        "nullable": true,
        "type": "integer"
      }
    },
    {
      "description": "Filter by transaction value (in wei) greater than this value",
      "in": "query",
      "name": "filterValueGt",
      "required": false,
      "schema": {
        "description": "Filter by transaction value (in wei) greater than this value",
        "type": "string"
      }
    },
    {
      "description": "Filter by function selector (4-byte method ID), e.g., '0xa9059cbb' for ERC-20 transfer",
      "in": "query",
      "name": "filterFunctionSelector",
      "required": false,
      "schema": {
        "description": "Filter by function selector (4-byte method ID), e.g., '0xa9059cbb' for ERC-20 transfer",
        "type": "string"
      }
    },
    {
      "description": "Current page number",
      "in": "query",
      "name": "page",
      "required": false,
      "schema": {
        "default": 1,
        "description": "Current page number",
        "nullable": true,
        "type": "number"
      }
    },
    {
      "description": "Number of items per page",
      "in": "query",
      "name": "limit",
      "required": false,
      "schema": {
        "default": 20,
        "description": "Number of items per page",
        "nullable": true,
        "type": "number"
      }
    },
    {
      "description": "Sort order: 'asc' for ascending, 'desc' for descending",
      "in": "query",
      "name": "sortOrder",
      "required": false,
      "schema": {
        "default": "desc",
        "description": "Sort order: 'asc' for ascending, 'desc' for descending",
        "enum": [
          "asc",
          "desc"
        ],
        "type": "string"
      }
    },
    {
      "description": "Chain ID(s) to request transaction data for. You can specify multiple chain IDs by repeating the parameter, up to a maximum of 50. Example: ?chainId=1&chainId=137",
      "in": "query",
      "name": "chainId",
      "required": true,
      "schema": {
        "description": "Chain ID(s) to request transaction data for. You can specify multiple chain IDs by repeating the parameter, up to a maximum of 50. Example: ?chainId=1&chainId=137",
        "items": {
          "type": "integer"
        },
        "maxItems": 50,
        "minItems": 1,
        "type": "array"
      }
    }
  ],
  "responses": {
    "200": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "result": {
                "properties": {
                  "pagination": {
                    "properties": {
                      "hasMore": {
                        "description": "Whether there are more items available",
                        "type": "boolean"
                      },
                      "limit": {
                        "default": 20,
                        "description": "Number of items per page",
                        "nullable": true,
                        "type": "number"
                      },
                      "page": {
                        "default": 1,
                        "description": "Current page number",
                        "nullable": true,
                        "type": "number"
                      },
                      "totalCount": {
                        "description": "Total number of items available",
                        "nullable": true,
                        "type": "number"
                      }
                    },
                    "type": "object"
                  },
                  "transactions": {
                    "description": "Array of wallet transactions.",
                    "items": {
                      "properties": {
                        "blockHash": {
                          "description": "The hash of the block containing this transaction.",
                          "type": "string"
                        },
                        "blockNumber": {
                          "description": "The block number containing this transaction.",
                          "type": "number"
                        },
                        "blockTimestamp": {
                          "description": "The timestamp of the block (Unix timestamp).",
                          "type": "number"
                        },
                        "chainId": {
                          "description": "The chain ID where the transaction occurred.",
                          "type": "string"
                        },
                        "contractAddress": {
                          "description": "Contract address created if this was a contract creation transaction.",
                          "type": "string"
                        },
                        "cumulativeGasUsed": {
                          "description": "Total gas used by all transactions in this block up to and including this one.",
                          "type": "number"
                        },
                        "data": {
                          "description": "The transaction input data.",
                          "type": "string"
                        },
                        "decoded": {
                          "description": "Decoded transaction data (included when ABI is available).",
                          "properties": {
                            "inputs": {
                              "additionalProperties": {
                                "nullable": true
                              },
                              "description": "Object containing decoded function parameters.",
                              "type": "object"
                            },
                            "name": {
                              "description": "The function name.",
                              "type": "string"
                            },
                            "signature": {
                              "description": "The function signature.",
                              "type": "string"
                            }
                          },
                          "required": [
                            "inputs",
                            "name",
                            "signature"
                          ],
                          "type": "object"
                        },
                        "effectiveGasPrice": {
                          "description": "The effective gas price paid (in wei as string).",
                          "type": "string"
                        },
                        "fromAddress": {
                          "description": "The address that initiated the transaction.",
                          "type": "string"
                        },
                        "functionSelector": {
                          "description": "The function selector (first 4 bytes of the transaction data).",
                          "type": "string"
                        },
                        "gas": {
                          "description": "The gas limit for the transaction.",
                          "type": "number"
                        },
                        "gasPrice": {
                          "description": "The gas price used for the transaction (in wei as string).",
                          "type": "string"
                        },
                        "gasUsed": {
                          "description": "The amount of gas used by the transaction.",
                          "type": "number"
                        },
                        "hash": {
                          "description": "The transaction hash.",
                          "type": "string"
                        },
                        "maxFeePerGas": {
                          "description": "Maximum fee per gas (EIP-1559).",
                          "type": "string"
                        },
                        "maxPriorityFeePerGas": {
                          "description": "Maximum priority fee per gas (EIP-1559).",
                          "type": "string"
                        },
                        "nonce": {
                          "description": "The transaction nonce.",
                          "type": "number"
                        },
                        "status": {
                          "description": "The transaction status (1 for success, 0 for failure).",
                          "type": "number"
                        },
                        "toAddress": {
                          "description": "The address that received the transaction.",
                          "type": "string"
                        },
                        "transactionIndex": {
                          "description": "The index of the transaction within the block.",
                          "type": "number"
                        },
                        "transactionType": {
                          "description": "The transaction type (0=legacy, 1=EIP-2930, 2=EIP-1559).",
                          "type": "number"
                        },
                        "value": {
                          "description": "The value transferred in the transaction (in wei as string).",
                          "type": "string"
                        }
                      },
                      "required": [
                        "blockHash",
                        "blockNumber",
                        "blockTimestamp",
                        "chainId",
                        "data",
                        "fromAddress",
                        "functionSelector",
                        "gas",
                        "gasPrice",
                        "hash",
                        "nonce",
                        "status",
                        "toAddress",
                        "transactionIndex",
                        "value"
                      ],
                      "type": "object"
                    },
                    "type": "array"
                  }
                },
                "required": [
                  "pagination",
                  "transactions"
                ],
                "type": "object"
              }
            },
            "required": [
              "result"
            ],
            "type": "object"
          }
        }
      },
      "description": "Wallet transactions retrieved successfully. Returns transaction data with metadata including pagination information and chain details. Includes decoded function calls when ABI is available."
    },
    "400": {
      "description": "Invalid request parameters. This occurs when the wallet address format is invalid, chainId array is empty or exceeds the maximum limit of 50, or pagination parameters are out of range."
    },
    "401": {
      "description": "Authentication required. The request must include a valid `x-client-id` header for frontend usage or `x-secret-key` for backend usage."
    },
    "404": {
      "description": "Wallet not found or no transactions available for the specified wallet address on the given blockchain networks."
    },
    "500": {
      "description": "Internal server error. This may occur due to network connectivity issues, external service unavailability, or unexpected server errors."
    }
  }
}