{
  "openapi": "3.0.3",
  "info": {
    "title": "MNDset DEX Public Token API",
    "version": "1.0.0",
    "description": "Published token data only. No authentication. 60 requests per minute per IP. Responses can be cached for 30 seconds; market snapshots use the existing ~60-second provider cache. No customer or private report data."
  },
  "servers": [
    {
      "url": "/"
    }
  ],
  "paths": {
    "/api/v1/tokens": {
      "get": {
        "summary": "List published tokens",
        "operationId": "listTokens",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 100
            }
          },
          {
            "name": "chain",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "solana",
                "ethereum",
                "bsc",
                "base",
                "polygon",
                "arbitrum",
                "optimism",
                "avalanche"
              ]
            }
          },
          {
            "name": "phase",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "live",
                "presale",
                "upcoming"
              ]
            }
          },
          {
            "name": "page",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 10000
            }
          },
          {
            "name": "per_page",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50,
              "default": 25
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Public JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data",
                    "meta"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Token"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/Meta"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not published, missing or disabled"
          },
          "422": {
            "description": "Invalid query parameters"
          },
          "429": {
            "description": "Rate limit exceeded; respect Retry-After",
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds to wait before retrying"
              }
            }
          }
        }
      }
    },
    "/api/v1/tokens/{slug}": {
      "get": {
        "summary": "Get one published token",
        "operationId": "getToken",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Public JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data",
                    "meta"
                  ],
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Token"
                    },
                    "meta": {
                      "$ref": "#/components/schemas/Meta"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not published, missing or disabled"
          },
          "422": {
            "description": "Invalid query parameters"
          },
          "429": {
            "description": "Rate limit exceeded; respect Retry-After",
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds to wait before retrying"
              }
            }
          }
        }
      }
    },
    "/api/v1/tokens/{slug}/market": {
      "get": {
        "summary": "Read an available market snapshot",
        "description": "data.status can be unavailable, no_contract, busy or another provider state. Missing market fields must not be interpreted as zero.",
        "operationId": "getTokenMarket",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Public JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data",
                    "meta"
                  ],
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Market"
                    },
                    "meta": {
                      "$ref": "#/components/schemas/Meta"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not published, missing or disabled"
          },
          "422": {
            "description": "Invalid query parameters"
          },
          "429": {
            "description": "Rate limit exceeded; respect Retry-After",
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Seconds to wait before retrying"
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Token": {
        "type": "object",
        "required": [
          "slug",
          "name",
          "symbol",
          "chain",
          "phase",
          "url",
          "claimed"
        ],
        "properties": {
          "slug": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "symbol": {
            "type": "string"
          },
          "chain": {
            "type": "string"
          },
          "phase": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "contract_address": {
            "type": "string",
            "nullable": true
          },
          "description": {
            "type": "string",
            "nullable": true
          },
          "logo_url": {
            "type": "string",
            "nullable": true
          },
          "presale_starts_at": {
            "type": "string",
            "nullable": true
          },
          "presale_ends_at": {
            "type": "string",
            "nullable": true
          },
          "launched_at": {
            "type": "string",
            "nullable": true
          },
          "published_at": {
            "type": "string",
            "nullable": true
          },
          "updated_at": {
            "type": "string",
            "nullable": true
          },
          "claimed": {
            "type": "boolean"
          },
          "links": {
            "type": "object",
            "properties": {
              "website": {
                "type": "string",
                "nullable": true
              },
              "telegram": {
                "type": "string",
                "nullable": true
              },
              "x": {
                "type": "string",
                "nullable": true
              },
              "discord": {
                "type": "string",
                "nullable": true
              },
              "whitepaper": {
                "type": "string",
                "nullable": true
              },
              "presale": {
                "type": "string",
                "nullable": true
              }
            }
          },
          "tokenomics": {
            "type": "object",
            "additionalProperties": {
              "type": "string",
              "nullable": true
            }
          }
        }
      },
      "Market": {
        "type": "object",
        "required": [
          "status"
        ],
        "properties": {
          "price_usd": {
            "type": "number",
            "nullable": true
          },
          "change_24h": {
            "type": "number",
            "nullable": true
          },
          "volume_24h": {
            "type": "number",
            "nullable": true
          },
          "liquidity_usd": {
            "type": "number",
            "nullable": true
          },
          "market_cap": {
            "type": "number",
            "nullable": true
          },
          "fdv": {
            "type": "number",
            "nullable": true
          },
          "status": {
            "type": "string"
          },
          "source": {
            "type": "string"
          },
          "fetched_at": {
            "type": "string"
          },
          "pair_address": {
            "type": "string"
          },
          "dex": {
            "type": "string"
          },
          "quote_symbol": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        }
      },
      "Meta": {
        "type": "object",
        "properties": {
          "version": {
            "type": "string"
          },
          "page": {
            "type": "integer"
          },
          "per_page": {
            "type": "integer"
          },
          "total": {
            "type": "integer"
          },
          "last_page": {
            "type": "integer"
          },
          "generated_at": {
            "type": "string"
          },
          "cache_seconds": {
            "type": "integer"
          }
        }
      }
    }
  }
}
