Rest API

Search…
Rest API
We have a rest endpoint for our GraphQL API. It currently only supports data fetching.
We ported over some of our GraphQL endpoints to REST using https://www.sofa-api.com/. All responses are flattened out and we apologize if the formatting / syntax is off as this was easiest way for us to not have to write separate REST endpoints. The inputs unlike the graphql server are snake case.
API Key
An api key is still required for our rest endpoint to track usage. The API key is expected to be header of the request:
Authorization: API_KEY
REST Endpoint
https://beta.api.solanalysis.com/rest
Current Supported Paths / APIs
/get-project-stats
- Fetches stats for projects and information, 
  - attributes, marketcap, volume, floor, avg price, etc
​
/get-project-stat-by-name
- Fetches project stat by name, used as a search as we have our own internal slug for projects
​
/get-market-place-snapshots
- Fetches token level information, attributes, where it's listed if it is, name, image
​
/get-project-stat-hist
- Fetches historical stats for a project, time granularity in 24H or 1H
 
/get-market-place-status
- Fetches market places information, the display name or site for a specific program
​
/get-token-state
- Fetches the live order book of a token
​
/get-market-place-actions-by-token
- Fetches marketplace history for a token
​
/get-wallet-stats
- Fetches wallet stats leaderboard
​
/get-wallet-stats-hist
- Fetches wallet stat for an address (rough est. of port value if exists)
Get Project Stats
Details on the inputs and responses found here Projects & Stats​
Getting project stats order by market cap
import requests
import json
​
url = "https://beta.api.solanalysis.com/rest/get-project-stats"
​
payload = json.dumps({
  "order_by": {
    "field_name": "market_cap",
    "sort_order": "DESC"
  }
})
headers = {
  'Authorization': API_KEY,
  'Content-Type': 'application/json'
}
​
response = requests.request("POST", url, headers=headers, data=payload)
​
print(response.text)
​
// CURL
​
curl --location --request POST 'https://beta.api.solanalysis.com/rest/get-project-stats' \
--header 'Authorization: API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "order_by": {
        "field_name": "market_cap",
        "sort_order": "DESC"
    }
}'
​
Getting a specific project 
import requests
import json
​
url = "https://beta.api.solanalysis.com/rest/get-project-stats"
​
payload = json.dumps({
  "conditions": {
    "project_ids": [
      "degods"
    ]
  }
})
headers = {
  'Authorization': API_KEY,
  'Content-Type': 'application/json'
}
​
response = requests.request("POST", url, headers=headers, data=payload)
​
print(response.text)
​
​
// CURL
​
curl --location --request POST 'https://beta.api.solanalysis.com/rest/get-project-stats' \
--header 'Authorization: API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "conditions": {
        "project_ids": ["degods"]
    }
}'
​
​
Get Project Stats By Name
Searching project stats by display name
import requests
import json
​
url = "https://beta.api.solanalysis.com/rest/get-project-stat-by-name"
​
payload = json.dumps({
  "condition": {
    "display_name": "degen"
  }
})
headers = {
  'Authorization': API_KEY,
  'Content-Type': 'application/json'
}
​
response = requests.request("POST", url, headers=headers, data=payload)
​
print(response.text)
​
​
​
//CURL
​
​
curl --location --request POST 'https://beta.api.solanalysis.com/rest/get-project-stat-by-name' \
--header 'Authorization: API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "condition": {
        "display_name": "degen"
    }
}'
​
​
Get Project Stat Hist
Getting historical stats. See Historical Statsfor a detailed information on the inputs and responses.
import requests
import json
​
url = "https://beta.api.solanalysis.com/rest/get-project-stat-hist"
​
payload = json.dumps({
  "conditions": {
    "project_ids": [
      "fractals"
    ],
    "start_timestamp": 1641128400,
    "end_timestamp": 1641158340,
    "time_granularity": "PER_HOUR"
  },
  "pagination_info": {
    "page_number": 1,
    "page_size": 5
  }
})
headers = {
  'Authorization': API_KEY,
  'Content-Type': 'application/json'
}
​
response = requests.request("POST", url, headers=headers, data=payload)
​
print(response.text)
​
​
// CURL
​
curl --location --request POST 'https://beta.api.solanalysis.com/rest/get-project-stat-hist' \
--header 'Authorization: API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
  "conditions": {
      "project_ids": ["fractals"],
      "start_timestamp": 1641128400,
      "end_timestamp": 1641158340,
      "time_granularity": "PER_HOUR"
    },
  "pagination_info": {
    "page_number": 1,
    "page_size": 5
  }
}'
​
Get Market Place Status
Gets information regarding a market place. Use this to tie their program/instance ids to their display name, website, etc. See Marketplace Statusfor more details on the response.
import requests
​
url = "https://beta.api.solanalysis.com/rest/get-market-place-status"
​
payload = ""
headers = {
  'Authorization': API_KEY
}
​
response = requests.request("POST", url, headers=headers, data=payload)
​
print(response.text)
​
​
// CURL
​
curl --location --request POST 'https://beta.api.solanalysis.com/rest/get-market-place-status' \
--header 'Authorization: API_KEY' \
--data-raw ''
Get Market Place Snapshot
The core of our token information. Contains all information for a token: project slug, attributes, display name, and where it is listed / highest bid. See Marketplace Snapshot for more details on the response.
Show recently listed degods
import requests
import json
​
url = "https://beta.api.solanalysis.com/rest/get-market-place-snapshots"
​
payload = json.dumps({
  "condition": {
    "project_ids": [
      {
        "project_id": "degods"
      }
    ]
  },
  "order_by": {
    "field_name": "lowest_listing_block_timestamp",
    "sort_order": "DESC"
  },
  "pagination_info": {
    "page_number": 1
  }
})
headers = {
  'Authorization': API_KEY,
  'Content-Type': 'application/json'
}
​
response = requests.request("POST", url, headers=headers, data=payload)
​
print(response.text)
​
​
// CURL 
​
curl --location --request POST 'https://beta.api.solanalysis.com/rest/get-market-place-snapshots' \
--header 'Authorization: API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
  "condition": {
      "project_ids": [{"project_id": "degods"}]
    },
  "order_by": {
      "field_name": "lowest_listing_block_timestamp",
      "sort_order": "DESC"
  },
  "pagination_info": {
    "page_number": 1
  }
}'
Show lowest listed degods
import requests
import json
​
url = "https://beta.api.solanalysis.com/rest/get-market-place-snapshots"
​
payload = json.dumps({
  "condition": {
    "project_ids": [
      {
        "project_id": "degods",
        "attributes": [
          {
            "name": "version",
            "type": "CATEGORY",
            "values": [
              "DeadGod"
            ]
          }
        ]
      }
    ]
  },
  "order_by": {
    "field_name": "lowest_listing_block_timestamp",
    "sort_order": "DESC"
  },
  "pagination_info": {
    "page_number": 1
  }
})
headers = {
  'Authorization': API_KEY,
  'Content-Type': 'application/json'
}
​
response = requests.request("POST", url, headers=headers, data=payload)
​
print(response.text)
​
​
// CURL
​
curl --location --request POST 'https://beta.api.solanalysis.com/rest/get-market-place-snapshots' \
--header 'Authorization: API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
  "condition": {
      "project_ids": [{"project_id": "degods", "attributes": [{"name": "version", "type": "CATEGORY", "values": ["DeadGod"]}]}]
    },
  "order_by": {
      "field_name": "lowest_listing_block_timestamp",
      "sort_order": "DESC"
  },
  "pagination_info": {
    "page_number": 1
  }
}'
​
Get 1 attribute SMBS
import requests
import json
​
url = "https://beta.api.solanalysis.com/rest/get-market-place-snapshots"
​
payload = json.dumps({
  "condition": {
    "project_ids": [
      {
        "project_id": "smb",
        "attributes": [
          {
            "name": "Attributes Count",
            "type": "NUMERIC",
            "values": [
              "1"
            ]
          }
        ]
      }
    ]
  },
  "order_by": {
    "field_name": "lowest_listing_block_timestamp",
    "sort_order": "DESC"
  },
  "pagination_info": {
    "page_number": 1
  }
})
headers = {
  'Authorization': API_KEY,
  'Contentzs-Type': 'application/json'
}
​
response = requests.request("POST", url, headers=headers, data=payload)
​
print(response.text)
​
​
// CURL
​
curl --location --request POST 'https://beta.api.solanalysis.com/rest/get-market-place-snapshots' \
--header 'Authorization: API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "condition": {
        "project_ids": [
            {
                "project_id": "smb",
                "attributes": [
                    {
                        "name": "Attributes Count",
                        "type": "NUMERIC",
                        "values": [
                            "1"
                        ]
                    }
                ]
            }
        ]
    },
    "order_by": {
        "field_name": "lowest_listing_block_timestamp",
        "sort_order": "DESC"
    },
    "pagination_info": {
        "page_number": 1
    }
}'
​
​
​
Get Token State & Get Marketplace Actions by Token
Reference Token State & History​
Get token state for FUsGSgD9sdnHugRCWHhoxLnyER4mwL7wcEYLyaz5zw66
import requests
import json
​
url = "https://beta.api.solanalysis.com/rest/get-token-state"
​
payload = json.dumps({
  "condition": {
    "token_addresses": [
      "FUsGSgD9sdnHugRCWHhoxLnyER4mwL7wcEYLyaz5zw66"
    ]
  },
  "pagination_info": {
    "page_number": 1
  }
})
headers = {
  'Authorization': API_KEY,
  'Content-Type': 'application/json'
}
​
response = requests.request("POST", url, headers=headers, data=payload)
​
print(response.text)
​
​
// CURL
​
curl --location --request POST 'https://beta.api.solanalysis.com/rest/get-token-state' \
--header 'Authorization: API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "condition": {
        "token_addresses": ["FUsGSgD9sdnHugRCWHhoxLnyER4mwL7wcEYLyaz5zw66"]
    },
    "pagination_info": {
        "page_number": 1
    }
}'
Get token history for FUsGSgD9sdnHugRCWHhoxLnyER4mwL7wcEYLyaz5zw66
import requests
import json
​
url = "https://beta.api.solanalysis.com/rest/get-market-place-actions-by-token"
​
payload = json.dumps({
  "condition": {
    "token_addresses": [
      "FUsGSgD9sdnHugRCWHhoxLnyER4mwL7wcEYLyaz5zw66"
    ]
  },
  "pagination_info": {
    "page_number": 1
  }
})
headers = {
  'Authorization': API_KEY,
  'Content-Type': 'application/json'
}
​
response = requests.request("POST", url, headers=headers, data=payload)
​
print(response.text)
​
​
​
// CURL
​
curl --location --request POST 'https://beta.api.solanalysis.com/rest/get-market-place-actions-by-token' \
--header 'Authorization: API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "condition": {
        "token_addresses": ["FUsGSgD9sdnHugRCWHhoxLnyER4mwL7wcEYLyaz5zw66"]
    },
    "pagination_info": {
        "page_number": 1
    }
}'
​
​
​
​
​
​
Developer Guide - Previous
Market Making
Next - API
Common Types
Last modified 1mo ago
Copy link
Outline
API Key
REST Endpoint
Current Supported Paths / APIs
Get Project Stats
Get Project Stats By Name
Get Project Stat Hist
Get Market Place Status
Get Market Place Snapshot
Get Token State & Get Marketplace Actions by Token