{
  "openapi": "3.0.1",
  "info": {
    "title": "Pump.fun Graduated Tokens Dataset",
    "description": "Historical + live pump.fun graduated tokens on Solana: launch time, graduation time, time-to-graduate, migration signature, PumpSwap pool and market-cap path (t+5m/1h/24h). One record per token.",
    "version": "0.1",
    "x-build-id": "fh131kC8Gvt6QbKsY"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/intenal_builds~pumpfun-graduated-tokens-dataset/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-intenal_builds-pumpfun-graduated-tokens-dataset",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/intenal_builds~pumpfun-graduated-tokens-dataset/runs": {
      "post": {
        "operationId": "runs-sync-intenal_builds-pumpfun-graduated-tokens-dataset",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/intenal_builds~pumpfun-graduated-tokens-dataset/run-sync": {
      "post": {
        "operationId": "run-sync-intenal_builds-pumpfun-graduated-tokens-dataset",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "mode": {
            "title": "Data source",
            "enum": [
              "both",
              "historical",
              "live"
            ],
            "type": "string",
            "description": "'historical' serves the bundled corpus (graduations from late Jul to late Sep 2026). 'live' fetches recently graduated coins from pump.fun's public API and resolves graduation time via public Solana RPC. 'both' returns live first, then historical.",
            "default": "both"
          },
          "startDate": {
            "title": "Graduated on/after",
            "type": "string",
            "description": "YYYY-MM-DD or ISO timestamp (UTC). Filters on graduation time. Empty = no lower bound."
          },
          "endDate": {
            "title": "Graduated on/before",
            "type": "string",
            "description": "YYYY-MM-DD (inclusive, UTC) or ISO timestamp. Empty = no upper bound."
          },
          "mints": {
            "title": "Mint addresses",
            "type": "array",
            "description": "Return only these token mint addresses. Empty = all tokens.",
            "items": {
              "type": "string"
            }
          },
          "minAthMarketCapUsd": {
            "title": "Min all-time-high market cap (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Keep tokens whose pump.fun-reported ATH market cap is at least this value. 0 = no filter.",
            "default": 0
          },
          "minMcapAtGraduationUsd": {
            "title": "Min market cap at graduation (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Keep tokens whose candle-derived market cap at graduation is at least this. Tokens without candle coverage at graduation are excluded when > 0.",
            "default": 0
          },
          "onlyWithPricePath": {
            "title": "Only tokens with a price path",
            "type": "boolean",
            "description": "Keep only tokens that have at least a t+5m market-cap value derived from candles.",
            "default": false
          },
          "includeNsfw": {
            "title": "Include NSFW-flagged tokens",
            "type": "boolean",
            "description": "Include tokens pump.fun flags as NSFW.",
            "default": true
          },
          "oldestFirst": {
            "title": "Oldest first (historical)",
            "type": "boolean",
            "description": "Sort historical records by graduation time ascending instead of newest first.",
            "default": false
          },
          "liveMaxTokens": {
            "title": "Max live tokens",
            "minimum": 0,
            "maximum": 500,
            "type": "integer",
            "description": "Maximum recently graduated tokens to fetch live (each needs ~2 public API calls; ~1.5 s per token).",
            "default": 50
          },
          "solanaRpcUrl": {
            "title": "Solana RPC URL (optional)",
            "type": "string",
            "description": "Optional own RPC endpoint for graduation-time lookups. Defaults to the free public mainnet-beta endpoint."
          },
          "maxResults": {
            "title": "Max results",
            "minimum": 1,
            "type": "integer",
            "description": "Maximum total tokens to output (each output token is one billable 'token' event).",
            "default": 1000
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}