api.slamai.dev

{
  "input": {
    "method": "GET",
    "queryParams": {
      "addresses": {
        "description": "Pipe-delimited token addresses. Max: 30. E.g. 0x123...|0x456...",
        "type": "string"
      },
      "blockchain": {
        "description": "The blockchain network to query.",
        "enum": [
          "ethereum",
          "base"
        ],
        "required": true,
        "type": "string"
      },
      "estimate_cost": {
        "description": "Return only SLAM token cost for this query",
        "type": "boolean"
      },
      "quote_address": {
        "description": "The contract address of the token to use for price output. Any ERC20 token address is supported.",
        "type": "string"
      },
      "quote_symbol": {
        "description": "The quote token to use for price output. Any ERC20 token symbol and many major tokens on other blockchains are supported. When multiple tokens have the same symbol, the system chooses the most active token with that symbol over the last 24 hours. Example: BRETT",
        "type": "string"
      },
      "symbols": {
        "description": "A pipe-delimited list of token symbols to query. When multiple tokens have the same symbol, the system chooses the most active token with that symbol over the last 24 hours. Example: SWARM|VADER Maximum: 30 symbols",
        "type": "string"
      }
    },
    "type": "http"
  },
  "output": {
    "content": {
      "application/json": {
        "schema": {
          "oneOf": [
            {
              "properties": {
                "block": {
                  "description": "The block number for this price snapshot.",
                  "format": "int32",
                  "type": "integer"
                },
                "chain": {
                  "description": "The blockchain network name (e.g., 'base').",
                  "minLength": 1,
                  "type": "string"
                },
                "quote": {
                  "description": "Quote token or currency (USD, ETH, BTC).",
                  "minLength": 1,
                  "type": "string"
                },
                "slam": {
                  "description": "The SLAM token cost for this API call.",
                  "format": "double",
                  "type": "number"
                },
                "tokens": {
                  "description": "List of token price data.",
                  "items": {
                    "properties": {
                      "address": {
                        "description": "Token contract address.",
                        "type": "string"
                      },
                      "fdv": {
                        "description": "Fully diluted valuation in USD.",
                        "format": "double",
                        "nullable": true,
                        "type": "number"
                      },
                      "liquidity": {
                        "description": "Available liquidity in USD.",
                        "format": "double",
                        "nullable": true,
                        "type": "number"
                      },
                      "name": {
                        "description": "Full token name.",
                        "type": "string"
                      },
                      "prev": {
                        "description": "Price change info over 24h.",
                        "items": {
                          "properties": {
                            "change": {
                              "description": "Price change percentage.",
                              "type": "string"
                            },
                            "minutes": {
                              "description": "Lookback period in minutes.",
                              "format": "int32",
                              "type": "integer"
                            }
                          },
                          "type": "object"
                        },
                        "type": "array"
                      },
                      "price": {
                        "description": "Current price in selected quote.",
                        "format": "double",
                        "type": "number"
                      },
                      "symbol": {
                        "description": "Token symbol.",
                        "type": "string"
                      }
                    },
                    "type": "object"
                  },
                  "type": "array"
                },
                "utc": {
                  "description": "UTC timestamp of this data (ISO 8601).",
                  "minLength": 1,
                  "type": "string"
                }
              },
              "required": [
                "block",
                "chain",
                "quote",
                "slam",
                "utc"
              ],
              "type": "object"
            },
            {
              "properties": {
                "slam": {
                  "format": "double",
                  "type": "number"
                }
              },
              "type": "object"
            }
          ]
        }
      }
    },
    "description": "OK",
    "status": 200
  }
}