# TPRO Public API

## Assumptions

| Field      | Type   | Description |
| ---------- | ------ | ----------- |
| dex        | String |             |
| cex        | String |             |
| vesting    | String |             |
| disclaimer | String |             |
| others     | String |             |

## String

The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.

## SocialEntry

| Field | Type   | Description |
| ----- | ------ | ----------- |
| name  | String |             |
| data  | String |             |

## Project

| Field        | Type           | Description |
| ------------ | -------------- | ----------- |
| slug         | String!        |             |
| symbol       | String         |             |
| name         | String         |             |
| averageScore | Float          |             |
| assumptions  | Assumptions    |             |
| logo         | String         |             |
| sources      | \[String]      |             |
| website      | String         |             |
| socials      | \[SocialEntry] |             |
| createdAt    | Int            |             |
| updatedAt    | Int            |             |

## Float

The `Float` scalar type represents signed double-precision fractional values as specified by [IEEE 754](https://en.wikipedia.org/wiki/IEEE_floating_point).

## Int

The `Int` scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.

## AgentsParams

| Field                         | Type  | Description |
| ----------------------------- | ----- | ----------- |
| base\_agent\_dollars          | Int   |             |
| base\_agent\_sale\_percentage | Float |             |
| sum\_dollars\_other\_agents   | Int   |             |

## SimulationShort

| Field                    | Type         | Description |
| ------------------------ | ------------ | ----------- |
| id                       | String       |             |
| execution\_time\_seconds | Int          |             |
| agents                   | \[String]    |             |
| agents\_params           | AgentsParams |             |
| liquidity\_reserve       | String       |             |
| liquidity\_tokens        | String       |             |
| score                    | Float        |             |
| createdAt                | Int          |             |

## Agent

| Field | Type         | Description |
| ----- | ------------ | ----------- |
| name  | String       |             |
| data  | \[\[String]] |             |

## MetricEntry

| Field | Type        | Description |
| ----- | ----------- | ----------- |
| name  | String      |             |
| data  | \[\[Float]] |             |

## Metric

| Field   | Type        | Description |
| ------- | ----------- | ----------- |
| median  | MetricEntry |             |
| average | MetricEntry |             |
| range   | MetricEntry |             |

## Strategy

| Field | Type   | Description |
| ----- | ------ | ----------- |
| name  | String |             |
| data  | Float  |             |

## Pool

| Field | Type        | Description |
| ----- | ----------- | ----------- |
| name  | String      |             |
| data  | \[Strategy] |             |

## MetricsData

| Field                                        | Type  | Description |
| -------------------------------------------- | ----- | ----------- |
| percentage\_timesteps\_above\_listing\_price | Float |             |
| min\_price                                   | Float |             |
| market\_cap\_for\_min\_price                 | Float |             |
| max\_price                                   | Float |             |
| market\_cap\_for\_max\_price                 | Float |             |
| increase\_timesteps\_percentage              | Float |             |
| price\_below\_25                             | Float |             |
| price\_above\_50                             | Float |             |
| longest\_increase\_trend                     | Int   |             |
| longest\_decrease\_trend                     | Int   |             |
| price\_change\_24h                           | Float |             |
| price\_change\_7d                            | Float |             |
| price\_change\_30d                           | Float |             |
| price\_change\_180d                          | Float |             |
| price\_change\_365d                          | Float |             |
| price\_change\_max                           | Float |             |

## VestingStackedArea

| Field         | Type           | Description |
| ------------- | -------------- | ----------- |
| vesting\_data | \[MetricEntry] |             |
| extra\_line   | MetricEntry    |             |

## TokenPoolDataset

| Field         | Type     | Description |
| ------------- | -------- | ----------- |
| name          | String   |             |
| data          | \[Float] |             |
| unit          | String   |             |
| type          | String   |             |
| valueDecimals | Int      |             |

## LiquidityPools

| Field    | Type                | Description |
| -------- | ------------------- | ----------- |
| xData    | \[Int]              |             |
| datasets | \[TokenPoolDataset] |             |

## ScoringData

| Field          | Type      | Description |
| -------------- | --------- | ----------- |
| main\_score    | Float     |             |
| average\_score | \[Int]    |             |
| categories     | \[String] |             |

## TokenPriceMonths

| Field | Type   | Description |
| ----- | ------ | ----------- |
| name  | String |             |
| data  | \[Int] |             |

## TokenPriceAverageTokenPrice

| Field | Type     | Description |
| ----- | -------- | ----------- |
| name  | String   |             |
| data  | \[Float] |             |

## TokenPriceAverageSoldTokens

| Field | Type   | Description |
| ----- | ------ | ----------- |
| name  | String |             |
| data  | \[Int] |             |

## TokenPriceAverageBoughtTokens

| Field | Type   | Description |
| ----- | ------ | ----------- |
| name  | String |             |
| data  | \[Int] |             |

## TokenPriceWithSupplyAndDemand

| Field                   | Type                          | Description |
| ----------------------- | ----------------------------- | ----------- |
| months                  | TokenPriceMonths              |             |
| average\_token\_price   | TokenPriceAverageTokenPrice   |             |
| average\_sold\_tokens   | TokenPriceAverageSoldTokens   |             |
| average\_bought\_tokens | TokenPriceAverageBoughtTokens |             |

## UnvestedVestedClaimedSoldRoundData

| Field            | Type   | Description |
| ---------------- | ------ | ----------- |
| unvested\_tokens | \[Int] |             |
| vested\_tokens   | \[Int] |             |
| claimed\_tokens  | \[Int] |             |
| sold\_tokens     | Metric |             |

## UnvestedVestedClaimedSoldRound

| Field | Type                               | Description |
| ----- | ---------------------------------- | ----------- |
| name  | String                             |             |
| data  | UnvestedVestedClaimedSoldRoundData |             |

## MarketDataset

| Field         | Type     | Description |
| ------------- | -------- | ----------- |
| name          | String   |             |
| data          | \[Float] |             |
| unit          | String   |             |
| type          | String   |             |
| valueDecimals | Int      |             |

## SecondaryMarketCumulative

| Field    | Type             | Description |
| -------- | ---------------- | ----------- |
| xData    | \[Int]           |             |
| datasets | \[MarketDataset] |             |

## Simulation

| Field                                   | Type                              | Description |
| --------------------------------------- | --------------------------------- | ----------- |
| id                                      | String                            |             |
| execution\_time\_seconds                | Int                               |             |
| agents                                  | \[String]                         |             |
| agents\_params                          | AgentsParams                      |             |
| liquidity\_reserve                      | String                            |             |
| liquidity\_tokens                       | String                            |             |
| score                                   | Float                             |             |
| sold\_individual\_agent                 | \[Agent]                          |             |
| bought\_individual\_agent               | \[Agent]                          |             |
| tokens\_bought\_metric                  | Metric                            |             |
| fully\_diluted\_valuation               | Metric                            |             |
| volume                                  | Metric                            |             |
| market\_cap                             | Metric                            |             |
| cumulative\_sold\_primary\_market       | Metric                            |             |
| token\_price                            | Metric                            |             |
| primary\_market\_profits                | Metric                            |             |
| min\_needed\_demand                     | Metric                            |             |
| tokens\_sold\_metric                    | Metric                            |             |
| strategies\_profits                     | \[Pool]                           |             |
| metrics                                 | MetricsData                       |             |
| primary\_market\_sold\_scatter\_plot    | \[MetricEntry]                    |             |
| vesting\_stacked\_area                  | VestingStackedArea                |             |
| liquidity\_pools                        | LiquidityPools                    |             |
| scoring                                 | ScoringData                       |             |
| token\_price\_with\_supply\_and\_demand | TokenPriceWithSupplyAndDemand     |             |
| unvested\_vested\_claimed\_sold         | \[UnvestedVestedClaimedSoldRound] |             |
| secondary\_market\_cumulative           | SecondaryMarketCumulative         |             |
| createdAt                               | Int                               |             |

## GetProjectsOutput

| Field     | Type       | Description |
| --------- | ---------- | ----------- |
| projects  | \[Project] |             |
| nextToken | String     |             |

## GetSimulationsOutput

| Field       | Type               | Description |
| ----------- | ------------------ | ----------- |
| simulations | \[SimulationShort] |             |
| nextToken   | String             |             |

## ProjectInfoDexSettingsInput

| Field          | Type  | Description |
| -------------- | ----- | ----------- |
| reserve        | Int   |             |
| tokens         | Int   |             |
| listing\_price | Float |             |

## ProjectInfoCexSettingsInput

| Field                  | Type  | Description |
| ---------------------- | ----- | ----------- |
| market\_maker\_dollars | Int   |             |
| market\_maker\_tokens  | Int   |             |
| listing\_price         | Float |             |

## ProjectInfoInput

| Field                 | Type                        | Description |
| --------------------- | --------------------------- | ----------- |
| project\_name         | String!                     |             |
| project\_symbol       | String!                     |             |
| project\_slug         | String!                     |             |
| number\_of\_timesteps | Int!                        |             |
| timestep\_duration    | String!                     |             |
| dex                   | Boolean!                    |             |
| dex\_settings         | ProjectInfoDexSettingsInput |             |
| cex                   | Boolean!                    |             |
| cex\_settings         | ProjectInfoCexSettingsInput |             |

## Boolean

The `Boolean` scalar type represents `true` or `false`.

## PrimaryMarketRoundSupplyStrategiesInput

| Field                        | Type     | Description |
| ---------------------------- | -------- | ----------- |
| strategy\_random             | Boolean! |             |
| strategy\_random\_aggressive | Boolean! |             |
| strategy\_1                  | Boolean! |             |
| strategy\_2                  | Boolean! |             |
| strategy\_3                  | Boolean! |             |

## PrimaryMarketRoundInput

| Field              | Type                                     | Description |
| ------------------ | ---------------------------------------- | ----------- |
| name               | String!                                  |             |
| type               | String!                                  |             |
| number\_of\_tokens | String!                                  |             |
| tge\_percentage    | Float!                                   |             |
| cliff              | Int!                                     |             |
| vesting            | Int!                                     |             |
| buy\_price         | Float!                                   |             |
| supply\_strategies | PrimaryMarketRoundSupplyStrategiesInput! |             |

## PrimaryMarketInput

| Field                   | Type                        | Description |
| ----------------------- | --------------------------- | ----------- |
| primary\_market\_rounds | \[PrimaryMarketRoundInput!] |             |

## SecondaryMarketAgentsInput

| Field                | Type     | Description |
| -------------------- | -------- | ----------- |
| base\_agent          | Boolean! |             |
| low\_advanced        | Boolean! |             |
| moderately\_advanced | Boolean! |             |
| very\_advanced       | Boolean! |             |
| speculator           | Boolean! |             |

## SecondaryMarketAgentsParamsInput

| Field                         | Type  | Description |
| ----------------------------- | ----- | ----------- |
| base\_agent\_dollars          | Int   |             |
| base\_agent\_sale\_percentage | Float |             |
| sum\_dollars\_other\_agents   | Int   |             |

## SecondaryMarketInput

| Field          | Type                             | Description |
| -------------- | -------------------------------- | ----------- |
| agents         | SecondaryMarketAgentsInput!      |             |
| agents\_params | SecondaryMarketAgentsParamsInput |             |

## AssumptionsInput

| Field      | Type   | Description |
| ---------- | ------ | ----------- |
| dex        | String |             |
| cex        | String |             |
| vesting    | String |             |
| disclaimer | String |             |
| others     | String |             |

## SocialEntryInput

| Field | Type    | Description |
| ----- | ------- | ----------- |
| name  | String! |             |
| data  | String! |             |

## CreateSimulationInput

| Field             | Type                  | Description |
| ----------------- | --------------------- | ----------- |
| name              | String!               |             |
| info              | ProjectInfoInput!     |             |
| primary\_market   | PrimaryMarketInput!   |             |
| secondary\_market | SecondaryMarketInput! |             |
| assumptions       | AssumptionsInput      |             |
| logo              | String!               |             |
| sources           | \[String!]            |             |
| website           | String                |             |
| socials           | \[SocialEntryInput!]  |             |

## PrimaryMarketRoundSupplyStrategies

| Field                        | Type    | Description |
| ---------------------------- | ------- | ----------- |
| strategy\_random             | Boolean |             |
| strategy\_random\_aggressive | Boolean |             |
| strategy\_1                  | Boolean |             |
| strategy\_2                  | Boolean |             |
| strategy\_3                  | Boolean |             |

## PrimaryMarketRound

| Field              | Type                               | Description |
| ------------------ | ---------------------------------- | ----------- |
| name               | String!                            |             |
| type               | String!                            |             |
| number\_of\_tokens | String!                            |             |
| tge\_percentage    | Float!                             |             |
| cliff              | Int!                               |             |
| vesting            | Int!                               |             |
| buy\_price         | Float                              |             |
| supply\_strategies | PrimaryMarketRoundSupplyStrategies |             |

## PrimaryMarket

| Field                   | Type                   | Description |
| ----------------------- | ---------------------- | ----------- |
| primary\_market\_rounds | \[PrimaryMarketRound!] |             |

## SecondaryMarketAgents

| Field                | Type     | Description |
| -------------------- | -------- | ----------- |
| base\_agent          | Boolean! |             |
| low\_advanced        | Boolean! |             |
| moderately\_advanced | Boolean! |             |
| very\_advanced       | Boolean! |             |
| speculator           | Boolean! |             |

## SecondaryMarketAgentsParams

| Field                         | Type  | Description |
| ----------------------------- | ----- | ----------- |
| base\_agent\_dollars          | Int   |             |
| base\_agent\_sale\_percentage | Float |             |
| sum\_dollars\_other\_agents   | Int   |             |

## SecondaryMarket

| Field          | Type                        | Description |
| -------------- | --------------------------- | ----------- |
| agents         | SecondaryMarketAgents!      |             |
| agents\_params | SecondaryMarketAgentsParams |             |

## ProjectInfoDexSettings

| Field          | Type  | Description |
| -------------- | ----- | ----------- |
| reserve        | Int   |             |
| tokens         | Int   |             |
| listing\_price | Float |             |

## ProjectInfoCexSettings

| Field                  | Type  | Description |
| ---------------------- | ----- | ----------- |
| market\_maker\_dollars | Int   |             |
| market\_maker\_tokens  | Int   |             |
| listing\_price         | Float |             |

## ProjectInfo

| Field         | Type                   | Description |
| ------------- | ---------------------- | ----------- |
| dex           | Boolean!               |             |
| dex\_settings | ProjectInfoDexSettings |             |
| cex           | Boolean!               |             |
| cex\_settings | ProjectInfoCexSettings |             |

## Config

| Field             | Type             | Description |
| ----------------- | ---------------- | ----------- |
| name              | String!          |             |
| info              | ProjectInfo!     |             |
| primary\_market   | PrimaryMarket!   |             |
| secondary\_market | SecondaryMarket! |             |

## RunningSimulation

| Field              | Type         | Description |
| ------------------ | ------------ | ----------- |
| id                 | String       |             |
| project\_name      | String       |             |
| project\_symbol    | String       |             |
| agents             | \[String]    |             |
| agents\_params     | AgentsParams |             |
| liquidity\_reserve | String       |             |
| liquidity\_tokens  | String       |             |
| createdAt          | Int          |             |

## FinishedSimulation

| Field                    | Type         | Description |
| ------------------------ | ------------ | ----------- |
| id                       | String       |             |
| project\_name            | String       |             |
| project\_symbol          | String       |             |
| execution\_time\_seconds | Int          |             |
| agents                   | \[String]    |             |
| agents\_params           | AgentsParams |             |
| liquidity\_reserve       | String       |             |
| liquidity\_tokens        | String       |             |
| score                    | Float        |             |
| logo                     | String       |             |
| slug                     | String!      |             |
| scoring                  | ScoringData  |             |
| createdAt                | Int          |             |

## GlobalStatistics

| Field                                  | Type  | Description |
| -------------------------------------- | ----- | ----------- |
| project\_count                         | Int   |             |
| simulation\_count                      | Int   |             |
| total\_execution\_time\_seconds        | Int   |             |
| total\_simulation\_data\_in\_kilobytes | Int   |             |
| total\_simulation\_data\_in\_gigabytes | Float |             |

## ScorePoint

| Field | Type | Description |
| ----- | ---- | ----------- |
| score | Int  |             |
| count | Int  |             |

## Account

| Field   | Type | Description |
| ------- | ---- | ----------- |
| address | ID!  |             |

## ID

The `ID` scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as `"4"`) or integer (such as `4`) input value will be accepted as an ID.

## AuthResponse

| Field   | Type     | Description |
| ------- | -------- | ----------- |
| token   | String!  |             |
| account | Account! |             |

## AccountAgentsParams

| Field                         | Type  | Description |
| ----------------------------- | ----- | ----------- |
| base\_agent\_dollars          | Int   |             |
| base\_agent\_sale\_percentage | Float |             |
| sum\_dollars\_other\_agents   | Int   |             |

## AccountScoringData

| Field          | Type      | Description |
| -------------- | --------- | ----------- |
| main\_score    | Float     |             |
| average\_score | \[Int]    |             |
| categories     | \[String] |             |

## AccountSimulation

| Field                    | Type                | Description |
| ------------------------ | ------------------- | ----------- |
| id                       | String              |             |
| project\_name            | String              |             |
| project\_symbol          | String              |             |
| execution\_time\_seconds | Int                 |             |
| agents                   | \[String]           |             |
| agents\_params           | AccountAgentsParams |             |
| liquidity\_reserve       | String              |             |
| liquidity\_tokens        | String              |             |
| score                    | Float               |             |
| logo                     | String              |             |
| slug                     | String!             |             |
| scoring                  | AccountScoringData  |             |
| createdAt                | Int                 |             |

## GetAccountSimulationsOutput

| Field       | Type                 | Description |
| ----------- | -------------------- | ----------- |
| simulations | \[AccountSimulation] |             |
| nextToken   | String               |             |

## GetSimulationFromPromptOutput

| Field | Type    | Description |
| ----- | ------- | ----------- |
| id    | String! |             |
| slug  | String! |             |

## Query

| Field                                | Type                        | Description                                                                         |
| ------------------------------------ | --------------------------- | ----------------------------------------------------------------------------------- |
| authChallengeMessage                 | String                      | Request new challenge message. Used for login through "authLogin" in the next step. |
| authLogin                            | AuthResponse                | Request temporary JWT token for login.                                              |
| getAccountProfile                    | Account                     | Get your profile. Requires a valid token.                                           |
| getAccountSimulations                | GetAccountSimulationsOutput | Get your simulations. Requires a valid token.                                       |
| getProject                           | Project                     | Get a single Project, based on it's slug.                                           |
| getProjects                          | GetProjectsOutput           | Get paginated list of Projects.                                                     |
| getSimulation                        | Simulation                  | Get single simulation. Requires Project slug and Simulation id.                     |
| getSimulations                       | GetSimulationsOutput        | Get paginated list of Simulations for Project. Requires Project slug.               |
| getLastConfig                        | Config                      | Get last used Simulation config for given Project.                                  |
| getRunningSimulations                | \[RunningSimulation]        | Get paginated list of currently running Simulations.                                |
| getLastFinishedSimulations           | \[FinishedSimulation]       | Get last 10 finished Simulations.                                                   |
| getGlobalStatistics                  | GlobalStatistics            | Get global statistics.                                                              |
| getGlobalSimulationScoreDistribution | \[ScorePoint]               | Get Simulation score distribution across platform.                                  |
| getGlobalProjectScoreDistribution    | \[ScorePoint]               | Get Project score distribution across platform.                                     |

## Mutation

| Field                      | Type                          | Description                                       |
| -------------------------- | ----------------------------- | ------------------------------------------------- |
| createSimulation           | String                        | Create new Simulation based on config parameters. |
| createSimulationFromPrompt | GetSimulationFromPromptOutput | Create new Simulation from given prompt.          |
