# Data API

## **1. New Tokens Filter**

* Path: /market/token/newTokens
* Method: GET
*   Params:\


    <table data-header-hidden><thead><tr><th></th><th width="139"></th><th width="104"></th><th></th></tr></thead><tbody><tr><td><strong>Parameter</strong></td><td><strong>Type</strong></td><td><strong>Example</strong></td><td><strong>Description</strong></td></tr><tr><td>marketCapMin</td><td>number</td><td>1000</td><td>The minimum value of the marketCap</td></tr><tr><td>marketCapMax</td><td>number</td><td>2000</td><td>The maximum value of the marketCap</td></tr><tr><td>tradeVolume24hMin</td><td>number</td><td>1000</td><td>The minimum value of the 24h trade volume</td></tr><tr><td>tradeVolume24hMax</td><td>number</td><td>2000</td><td>The maximum value of the 24h trade volume</td></tr><tr><td>bondingCurveProgressMin</td><td>number</td><td>50</td><td>The minimum value of the bonding curve progress</td></tr><tr><td>bondingCurveProgressMax</td><td>number</td><td>98</td><td>The maximum value of the bonding curve progress</td></tr><tr><td>tradeCount24hMin</td><td>number</td><td>200</td><td>The minimum value of the 24h trade count</td></tr><tr><td>tradeCount24hMax</td><td>number</td><td>500</td><td>The maximum value of the 24h trade count</td></tr><tr><td>buyCount24hMin</td><td>number</td><td>100</td><td>The minimum value of the 24h buy count</td></tr><tr><td>buyCount24hMax</td><td>number</td><td>200</td><td>The maximum value of the 24h buy count</td></tr><tr><td>sellCount24hMin</td><td>number</td><td>100</td><td>The minimum value of the 24h sell count</td></tr><tr><td>sellCount24hMax</td><td>number</td><td>200</td><td>The maximum value of the 24h sell count</td></tr><tr><td>liquidityMin</td><td>number</td><td>20</td><td>The minimum value of the liquidity</td></tr><tr><td>liquidityMax</td><td>number</td><td>30</td><td>The maximum value of the liquidity</td></tr></tbody></table>
* Example
  *   request

      https://meme-api.openocean.finance/market/token/newTokens
  *   response

      ```javascript
      {
          "code": 0,
          "msg": "success",
          "ts": 1732760720635,
          "data": [
              {
                  "address": "8qsPqXUsj83aMBfwr8MeLHd19be6mryTJCUFKgGSpump",
                  "symbol": "CHARON",
                  "name": "CHARON AI",
                  "totalSupply": 1000000000,
                  "decimals": 6,
                  "logo": "https://ipfs.io/ipfs/QmafVycDyUF6v8NZssGBALd2HUgTghPVH6ZttbeEEKXoR5",
                  "creator": "GDnsYHFzxxN93RBoSFPK4RsMWug74339Ns6uLBqFAKkx",
                  "description": "Charon AI: A revolutionary quantum-powered artificial intelligence system designed for advanced neural processing and deep learning optimization. Experience unprecedented computational capabilities with our cutting-edge cybernetic architecture and neural network integration.",
                  "showName": true,
                  "twitter": "https://x.com/CharonAIpf",
                  "telegram": "https://t.me/CharonAIpf",
                  "website": "https://charonai.space/",
                  "blockNumber": 304046304,
                  "hash": "4fHYShfFrhoWfcMKwEKhnXDy72xEAVfSv4z2bRhZzmzokd5Y269iqRkpEFVV4Y7dDr2B4iqQXSByjT5jDVrXsxzM",
                  "source": "pump",
                  "dex": null,
                  "timestamp": 1732760686000,
                  "migrateTime": null,
                  "completeTime": null,
                  "marketCap": 8885.9233203,
                  "tradeVolume": 2625.2889068185,
                  "tradeCount": 10,
                  "top10Holder": 0.146726,
                  "bondingCurveProgress": 18.500343,
                  "status": "NEW",
                  "tradeVolume24h": 2625.2889068185,
                  "buyVolume24h": 1892.0733719389,
                  "sellVolume24h": 733.2155348796,
                  "tradeCount24h": 10,
                  "buyCount24h": 9,
                  "sellCount24h": 1,
                  "liquidity": 4.752144005
              }
          ],
          "error": false
      }
      ```

## **2. Token List**

* Path: /market/token/tokens
* Method: GET
*   Params:

    | **Parameter** | **Type** | **Example** | **Description**                        |
    | ------------- | -------- | ----------- | -------------------------------------- |
    | Type          | number   | 1           | 1: NEW 2: Graduating soon 3: Graduated |
* Example
  *   request

      https://meme-api.openocean.finance/market/token/tokens?Type=2
  *   response

      ```javascript
      {
          "code": 0,
          "msg": "success",
          "ts": 1732763589560,
          "data": [
              {
                  "address": "BSRjBP7GXKkJgwn6TDH8tQW1qdfUNCmm8MDiRiPDpump",
                  "symbol": "Bitchcoin",
                  "name": "Bitchcoin",
                  "totalSupply": 1000000000,
                  "decimals": 6,
                  "logo": "https://ipfs.io/ipfs/Qmc13ZRQeay5Ca1h9ncyStugRSkdtZpr36BsZH7isdBDmG",
                  "creator": "EpG5WSoBj2kwfbUDYUgaYaztCHykuk7owpivyjp3FDGp",
                  "description": "",
                  "showName": true,
                  "twitter": "https://x.com/bryanbrinkman/status/1861970322007711859",
                  "telegram": "",
                  "website": "https://en.m.wikipedia.org/wiki/Bitchcoin",
                  "blockNumber": 304052583,
                  "hash": "YTKfAucvY1V8fVJQFEJgdSkVcQ1apc5QKX4Vw3rev5DduraRtB8eUsREqbGeZrcpEjKN9jir3WTtdJuKNFGqF3s",
                  "source": "pump",
                  "dex": null,
                  "timestamp": 1732763404000,
                  "migrateTime": null,
                  "completeTime": 1732763430000,
                  "marketCap": 95817.623783653,
                  "tradeVolume": 44544.443383254,
                  "tradeCount": 130,
                  "top10Holder": 0.372159,
                  "bondingCurveProgress": 100,
                  "status": "COMPLETE",
                  "tradeVolume24h": 44544.443383254,
                  "buyVolume24h": 32570.620949015,
                  "sellVolume24h": 11973.822434239,
                  "tradeCount24h": 130,
                  "buyCount24h": 118,
                  "sellCount24h": 12,
                  "liquidity": 80.686557556
              }
          ],
          "error": false
      }
      ```

## **3. Token Detail**

* Path /market/token/detail
* Method: GET
*   Params:

    | **Parameter** | **Type** | **Example**                                  | **Description** |
    | ------------- | -------- | -------------------------------------------- | --------------- |
    | address       | string   | BSRjBP7GXKkJgwn6TDH8tQW1qdfUNCmm8MDiRiPDpump | token address   |
* Example:
  *   request

      https://meme-api.openocean.finance/market/token/detail?address=BSRjBP7GXKkJgwn6TDH8tQW1qdfUNCmm8MDiRiPDpump
  *   response

      ```javascript
      {
          "code": 0,
          "msg": "success",
          "ts": 1732763941361,
          "data": {
              "address": "BSRjBP7GXKkJgwn6TDH8tQW1qdfUNCmm8MDiRiPDpump",
              "bondingCurve": "Dd5b2cFyvzn72jZw86zUdReTYBTEH1GTUDSg5zF26cyH",
              "associatedBondingCurve": "ACWaqnZ7PuaMKqQqNN2syENqMJUCXFxJCiv4JXYJfWE4",
              "symbol": "Bitchcoin",
              "name": "Bitchcoin",
              "totalSupply": 1000000000,
              "decimals": 6,
              "logo": "https://ipfs.io/ipfs/Qmc13ZRQeay5Ca1h9ncyStugRSkdtZpr36BsZH7isdBDmG",
              "creator": "EpG5WSoBj2kwfbUDYUgaYaztCHykuk7owpivyjp3FDGp",
              "description": "",
              "showName": true,
              "twitter": "https://x.com/bryanbrinkman/status/1861970322007711859",
              "telegram": "",
              "website": "https://en.m.wikipedia.org/wiki/Bitchcoin",
              "blockNumber": 304052583,
              "hash": "YTKfAucvY1V8fVJQFEJgdSkVcQ1apc5QKX4Vw3rev5DduraRtB8eUsREqbGeZrcpEjKN9jir3WTtdJuKNFGqF3s",
              "source": "pump",
              "dex": "raydium",
              "timestamp": 1732763404000,
              "virtualTokenReserves": 279900000000000,
              "virtualSolReserves": 115005359120,
              "price": 0.000022630668593187,
              "priceSol": 0.000000093538350802,
              "solPrice": 241.94,
              "marketCap": 22630.668593187,
              "liquidity": 79.00535912,
              "tradeUserCount": 702,
              "priceChangePercent24h": 2.1849,
              "tradeVolume": 393581.69079468364,
              "tradeVolume24h": 393581.69079468364,
              "buyVolume24h": 202370.582791104,
              "sellVolume24h": 191211.1080035796,
              "bondingCurveProgress": 100,
              "tradeCount": 1632,
              "tradeCount24h": 1632,
              "buyCount24h": 911,
              "sellCount24h": 721,
              "top10Holder": 0.372159,
              "status": "MIGRATE",
              "realTokenReserves": "222550964191312",
              "realSolReserves": "7.900535912E+10"
          },
          "error": false
      }
      ```

## **4. Token Transactions**

* Path: /market/token/trades
* Method: GET
*   Params:

    | **Parameter** | **Type** | **Example**                                  | **Description** |
    | ------------- | -------- | -------------------------------------------- | --------------- |
    | address       | string   | BSRjBP7GXKkJgwn6TDH8tQW1qdfUNCmm8MDiRiPDpump | token address   |
* Example:
  *   request

      https://meme-api.openocean.finance/market/token/trades?address=BSRjBP7GXKkJgwn6TDH8tQW1qdfUNCmm8MDiRiPDpump
  *   response

      ```javascript
      {
          "code": 0,
          "msg": "success",
          "ts": 1732764256968,
          "data": [
              {
                  "hash": "24eG833zUThvrrPkKPsR2QcwrDGx8PR8desKHCaNwrNoy9YJW7HKfRqPMmbJ3HFB1deHzv5bNLV61Nu4rVcLJ5QG",
                  "address": "BSRjBP7GXKkJgwn6TDH8tQW1qdfUNCmm8MDiRiPDpump",
                  "account": "CKeqPxTEVJUbQbgExArCeYLiyWeuho2b3FR3WJNJVH8r",
                  "side": "SELL",
                  "amount": 1021564.970295,
                  "volume": 12.548705615,
                  "price": 0.000012283805709759,
                  "tradeTime": 1732764241000,
                  "source": "raydium"
              }
          ],
          "error": false
      }
      ```

## **5. User Transactions**

* Path /trading/userTrades
* Method: GET
*   Params:

    | **Parameter** | **Type** | **Example**                                  | **Description** |
    | ------------- | -------- | -------------------------------------------- | --------------- |
    | address       | string   | Bw6JTAqXEredtatiCWBxfKreUKd2bqSJiLQX28yvpump | token address   |
    | account       | string   | uExXZEFGVoFMybEZkRxJhaMfN4gpkw8CZeQndDbvnPc  | user account    |
* Example:
  *   request

      https://meme-api.openocean.finance/trading/userTrades?address=Bw6JTAqXEredtatiCWBxfKreUKd2bqSJiLQX28yvpump\&account=uExXZEFGVoFMybEZkRxJhaMfN4gpkw8CZeQndDbvnPc
  *   response

      ```javascript
      {
          "code": 0,
          "msg": "success",
          "ts": 1732767241609,
          "data": [
              {
                  "hash": "5xFJGTARKPv6UKBmULuj3Y9unxmwV3n3bX4RAxduk9LjTP3TMDrkhxfTdFznvPEEDPSAAEgAiQN26DDcSwWEHHUz",
                  "account": "uExXZEFGVoFMybEZkRxJhaMfN4gpkw8CZeQndDbvnPc",
                  "side": "BUY",
                  "amount": 26322.327608000,
                  "volume": 0.229785312,
                  "price": 0.000008729672976570,
                  "tradeTime": 1732710175000,
                  "source": "pump"
              }
          ],
          "error": false
      }
      ```

## **6. User Positions**

* Path /trading/userHolds
* Method: GET
*   Params:

    | **Parameter** | **Type** | **Example**                                 | **Description** |
    | ------------- | -------- | ------------------------------------------- | --------------- |
    | account       | string   | uExXZEFGVoFMybEZkRxJhaMfN4gpkw8CZeQndDbvnPc | user account    |
* Example:
  *   request

      https://meme-api.openocean.finance/trading/userHolds?account=uExXZEFGVoFMybEZkRxJhaMfN4gpkw8CZeQndDbvnPc
  *   response

      ```javascript
      {
          "code": 0,
          "msg": "success",
          "ts": 1732767664102,
          "data": [
              {
                  "address": "Bw6JTAqXEredtatiCWBxfKreUKd2bqSJiLQX28yvpump",
                  "symbol": "GSWIFT",
                  "logo": "https://ipfs.io/ipfs/QmbH8pMDhNu3k31kyn1LYpggyLC9nM18jmiSquY1bAf2cF",
                  "account": "uExXZEFGVoFMybEZkRxJhaMfN4gpkw8CZeQndDbvnPc",
                  "holdAmount": 26322.327608000,
                  "buyAmount": 26322.327608000,
                  "buyVolume": 0.229785312,
                  "buyCount": 1,
                  "buyAvgPrice": 0.000008730,
                  "sellAmount": 0.000000000,
                  "sellVolume": 0.000000000,
                  "sellCount": 0,
                  "sellAvgPrice": 0.000000000,
                  "price": 0.000007244401601991,
                  "totalProfit": 0.000000000,
                  "lastActiveTime": 1732710175000,
                  "source": "pump"
              }
          ],
          "error": false
      }
      ```

## **7. Kline**

* Path: /market/kline/list
* Method: GET
*   Params:

    | **Parameter** | **Type** | **Example**                                  | **Descirption** |
    | ------------- | -------- | -------------------------------------------- | --------------- |
    | account       | string   | DE73c4hvot9sWzshi42s3xnqzuMkLzu2PmLyQWJGpump | token address   |
    | period        | string   | 1m                                           | 1m/15m/1h/1d    |
    | startTime     | number   | 1732757400000                                | start time      |
    | endTime       | number   | 1732768200000                                | end time        |
* Example:
  *   request

      https://meme-api.openocean.finance/market/kline/list?address=DE73c4hvot9sWzshi42s3xnqzuMkLzu2PmLyQWJGpump\&period=1m\&startTime=1732757400000\&endTime=1732768200000
  *   response

      ```javascript
      {
          "code": 0,
          "msg": "success",
          "ts": 1732768205773,
          "data": [
              {
                  "beginTime": 1732768140,
                  "endTime": 1732768200,
                  "openPrice": 0.000306560618,
                  "highPrice": 0.000357840085,
                  "lowPrice": 0.000253239743,
                  "closePrice": 0.000262784526,
                  "volume": 117293512.479,
                  "quoteVolume": 35029.723807769,
                  "count": 151
              }
          ],
          "error": false
      }
      ```





