api.slamai.dev

{
  "input": {
    "method": "GET",
    "queryParams": {
      "activity_window": {
        "description": "The length of time over which activity is measured.",
        "enum": [
          "5min",
          "15min",
          "1h",
          "3h",
          "6h",
          "1d"
        ],
        "type": "string"
      },
      "blockchain": {
        "description": "The blockchain to query",
        "enum": [
          "ethereum",
          "base"
        ],
        "required": true,
        "type": "string"
      },
      "category": {
        "description": "Filter by token category. Currently, only 'virtuals' on Base is supported.",
        "type": "string"
      },
      "estimate_cost": {
        "description": "When true, returns only the SLAM token cost of this query",
        "type": "boolean"
      },
      "num": {
        "description": "The maximum number of tokens to return. Max: 1000.",
        "format": "int32",
        "type": "integer"
      }
    },
    "type": "http"
  },
  "output": {
    "content": {
      "application/json": {
        "schema": {
          "oneOf": [
            {
              "properties": {
                "block": {
                  "description": "The block number at which this data snapshot was generated",
                  "format": "int32",
                  "type": "integer"
                },
                "chain": {
                  "description": "The name of the blockchain network (e.g., 'base')",
                  "type": "string"
                },
                "slam": {
                  "description": "The SLAM token cost for this API call",
                  "format": "double",
                  "type": "number"
                },
                "tokens": {
                  "description": "List of trending tokens for the specified activity window and category",
                  "items": {
                    "properties": {
                      "address": {
                        "description": "The token contract address",
                        "type": "string"
                      },
                      "fdv": {
                        "description": "The token’s fully diluted valuation in USD",
                        "format": "double",
                        "type": "number"
                      },
                      "first_minted": {
                        "properties": {
                          "block": {
                            "description": "The block number of the first mint",
                            "format": "int32",
                            "type": "integer"
                          },
                          "hash": {
                            "description": "The transaction hash of the first mint",
                            "type": "string"
                          },
                          "utc": {
                            "description": "The UTC timestamp of the mint (ISO 8601 format)",
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "liquidity": {
                        "description": "The liquidity value for the token in USD",
                        "format": "double",
                        "type": "number"
                      },
                      "name": {
                        "description": "The full name of the token",
                        "type": "string"
                      },
                      "rank": {
                        "description": "The token’s newness rank, determined by timestamp of its first mint",
                        "format": "int32",
                        "type": "integer"
                      },
                      "symbol": {
                        "description": "The token’s symbol (e.g., 'SLAM')",
                        "type": "string"
                      },
                      "usd": {
                        "properties": {
                          "cur": {
                            "description": "The current token price in USD",
                            "format": "double",
                            "type": "number"
                          },
                          "prev": {
                            "description": "Previous price data for comparison",
                            "items": {
                              "properties": {
                                "change": {
                                  "description": "Price change percentage.",
                                  "type": "string"
                                },
                                "minutes": {
                                  "description": "Lookback period in minutes.",
                                  "format": "int32",
                                  "type": "integer"
                                }
                              },
                              "type": "object"
                            },
                            "type": "array"
                          }
                        },
                        "type": "object"
                      }
                    },
                    "type": "object"
                  },
                  "type": "array"
                },
                "utc": {
                  "description": "The UTC timestamp of the block used for the response (ISO 8601 format)",
                  "type": "string"
                }
              },
              "type": "object"
            },
            {
              "properties": {
                "slam": {
                  "format": "double",
                  "type": "number"
                }
              },
              "type": "object"
            }
          ]
        }
      }
    },
    "description": "OK",
    "status": 200
  }
}