OpenSea · Schema

TokenSwapActivityResponse

A token swap activity event

NFTMarketplaceWeb3BlockchainTradingDigital Assets

Properties

Name	Type	Description
id	string	Unique identifier for the swap event
timestamp	string	Timestamp of the swap
sender_address	string	Address of the sender
from_token	object	Token sold in the swap
to_token	object	Token bought in the swap
transaction_hash	string	Transaction hash
user_op_hash	string	User operation hash (for account abstraction)
swap_protocol	string	Swap protocol used
chain	string	Blockchain the swap occurred on

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://opensea.io/schemas/TokenSwapActivityResponse",
  "title": "TokenSwapActivityResponse",
  "type": "object",
  "description": "A token swap activity event",
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique identifier for the swap event"
    },
    "timestamp": {
      "type": "string",
      "format": "date-time",
      "description": "Timestamp of the swap"
    },
    "sender_address": {
      "type": "string",
      "description": "Address of the sender"
    },
    "from_token": {
      "$ref": "#/components/schemas/TokenAmountResponse",
      "description": "Token sold in the swap"
    },
    "to_token": {
      "$ref": "#/components/schemas/TokenAmountResponse",
      "description": "Token bought in the swap"
    },
    "transaction_hash": {
      "type": "string",
      "description": "Transaction hash"
    },
    "user_op_hash": {
      "type": "string",
      "description": "User operation hash (for account abstraction)"
    },
    "swap_protocol": {
      "type": "string",
      "description": "Swap protocol used"
    },
    "chain": {
      "type": "string",
      "description": "Blockchain the swap occurred on"
    }
  },
  "required": [
    "chain",
    "from_token",
    "id",
    "sender_address",
    "timestamp",
    "to_token",
    "transaction_hash"
  ]
}