api.slamai.dev

{
  "input": {
    "method": "GET",
    "queryParams": {
      "addresses": {
        "description": "Pipe-delimited list of token contract addresses (e.g., 0xabc...|0xdef...). Cannot be used with 'symbols'. Max 30 addresses.",
        "type": "string"
      },
      "blockchain": {
        "description": "The blockchain network to query.",
        "enum": [
          "ethereum",
          "base"
        ],
        "required": true,
        "type": "string"
      },
      "estimate_cost": {
        "description": "When true, only returns the SLAM token cost for this request. Does not include token price data.",
        "type": "boolean"
      },
      "quote_symbol": {
        "description": "Quote token or currency to return prices in.",
        "enum": [
          "USD",
          "ETH",
          "BTC"
        ],
        "type": "string"
      },
      "symbols": {
        "description": "Pipe-delimited list of token symbols to query (e.g., SWARM|VADER). Cannot be used with 'addresses'. Max 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
  }
}