# Table of Contents - [TapTools - API Documentation](#taptools-api-documentation) --- # TapTools - API Documentation [![TapTools](https://taptools-public.s3.amazonaws.com/images/taptools-name.png)](https://taptools.io/) * Introduction * Rate Limiting * Metrics * Metrics * getNumber of requests * Market * Market * getMarket stats * Market » NFTs * getNFT sale history * getNFT stats * getNFT traits * getCollection assets * getHolder distribution * getTop holders * getTrended holders * getCollection info * getNumber of active listings * getNFT listings depth * getGet list of active listings * getNFT listings trended * getNFT floor price OHLCV * getCollection stats * getCollection stats (extended) * getTrades * getTrading stats * getCollection trait prices * getCollection metadata rarity * getNFT rarity rank * getNFT volume trended * getMarket-wide NFT stats * getMarket-wide NFT stats (extended) * getNFT market volume * getNFT Marketplace stats * getNFT top rankings * getTop volume collections * getTop volume collections (extended) * Market » Tokens * getActive loans * getLoan offers * getToken holders * getTop token holders * getToken price indicators * getToken links * getToken market cap * getToken price OHLCV * getToken liquidity pools * postToken prices * getToken price percent change * getQuote price * getAvailable quote currencies * getTop liquidity tokens * getTop market cap tokens * getTop volume tokens * getToken trades * getTrading stats * Onchain * Onchain » Asset * getAsset supply * Onchain » Address * getAddress info * getAddress UTxOs * Onchain » Transaction * getTransaction UTxOs * Wallet * Wallet » Portfolio * getPortfolio positions * getTrade history (tokens) * getPortfolio trended value * Integration * Integration * getToken by ID * getBlock * getEvents * getDEX * getLatest block * getPair by ID [![redocly logo](https://cdn.redoc.ly/redoc/logo-mini.svg)API docs by Redocly](https://redocly.com/redoc/) TapTools - API Documentation (1.8.1) ==================================== API Support: [support@taptools.io](mailto:support@taptools.io) URL: [https://taptools.io](https://taptools.io/) TapTools is a data provider that offers onchain data for assets on the Cardano network. [](https://openapi.taptools.io/#section/Introduction) Introduction ------------------------------------------------------------------ This API includes many of the same endpoints that power the [TapTools website](https://taptools.io/) . We have indexed onchain market data for both fungible and non-fungible tokens, as well as included endpoints to query raw onchain data. [](https://openapi.taptools.io/#section/Rate-Limiting) Rate Limiting -------------------------------------------------------------------- This API implements rate limiting to ensure resources aren't overwhelmed. This rate limit varies by plan. [](https://openapi.taptools.io/#tag/Metrics) Metrics ---------------------------------------------------- [](https://openapi.taptools.io/#tag/Metrics/paths/~1metrics/get) Number of requests ----------------------------------------------------------------------------------- Get the number of requests made by day over the last 30d. ##### Authorizations: _ApiAuthKey_ ### Responses **200** Number of requests **400** Bad Request **401** Not Authorized **429** Rate Limit Exceeded **500** Interval Server Error get/metrics TapTools OpenAPI https://openapi.taptools.io/api/v1/metrics ### Response samples * 200 * 400 * 401 * 429 * 500 Content type application/json Copy Expand all Collapse all `[ * { * "calls": 4837, * "time": 1692781200 } ]` [](https://openapi.taptools.io/#tag/Market) Market -------------------------------------------------- [](https://openapi.taptools.io/#tag/Market/paths/~1market~1stats/get) Market stats ---------------------------------------------------------------------------------- Get aggregated market stats, including 24h DEX volume and total active addresses onchain. Active addresses are addresses that have either sent or received any transactions within the last 24 hours. Multiple addresses with the same stake key will be counted as one address. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | quote | string

Example: quote=ADA

Quote currency to use (ADA, USD, EUR, ETH, BTC). Default is `ADA`. | ### Responses **200** **400** Bad Request **401** Not Authorized **429** Rate Limit Exceeded **500** Interval Server Error get/market/stats TapTools OpenAPI https://openapi.taptools.io/api/v1/market/stats ### Response samples * 200 * 400 * 401 * 429 * 500 Content type application/json Copy `{ * "activeAddresses": 24523, * "dexVolume": 8134621.35 }` [](https://openapi.taptools.io/#tag/Market-NFTs) Market » NFTs -------------------------------------------------------------- [](https://openapi.taptools.io/#tag/Market-NFTs/paths/~1nft~1asset~1sales/get) NFT sale history ----------------------------------------------------------------------------------------------- Get a specific asset's sale history. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | policy

required | string

Example: policy=40fa2aa67258b4ce7b5782f74831d46a84c59a0ff0c28262fab21728

The policy ID for the collection. | | name | string

Example: name=ClayNation3725

The name of a specific NFT to get stats for. | ### Responses **200** NFT Sale History. **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/nft/asset/sales TapTools OpenAPI https://openapi.taptools.io/api/v1/nft/asset/sales ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy Expand all Collapse all `[ * { * "buyerStakeAddress": "stake1address2", * "price": 8000, * "sellerStakeAddress": "stake1address1", * "time": 16000840 } ]` [](https://openapi.taptools.io/#tag/Market-NFTs/paths/~1nft~1asset~1stats/get) NFT stats ---------------------------------------------------------------------------------------- Get high-level stats on a certain NFT asset. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | policy

required | string

Example: policy=40fa2aa67258b4ce7b5782f74831d46a84c59a0ff0c28262fab21728

The policy ID for the collection. | | name

required | string

Example: name=ClayNation3725

The name of a specific NFT to get stats for. | ### Responses **200** NFT stats **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/nft/asset/stats TapTools OpenAPI https://openapi.taptools.io/api/v1/nft/asset/stats ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy `{ * "isListed": true, * "lastListedPrice": 3850, * "lastListedTime": 160002490, * "lastSoldPrice": 4800, * "lastSoldTime": 160008490, * "owners": 6, * "sales": 5, * "timesListed": 8, * "volume": 54234 }` [](https://openapi.taptools.io/#tag/Market-NFTs/paths/~1nft~1asset~1traits/get) NFT traits ------------------------------------------------------------------------------------------ Get a specific NFT's traits and trait prices. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | policy

required | string

Example: policy=40fa2aa67258b4ce7b5782f74831d46a84c59a0ff0c28262fab21728

The policy ID for the collection. | | name

required | string

Example: name=ClayNation3725

The name of a specific NFT to get stats for. | | prices | string

Example: prices=0

Include trait prices or not, Options are `0`, `1`. Default is `1`. | ### Responses **200** NFT traits. **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/nft/asset/traits TapTools OpenAPI https://openapi.taptools.io/api/v1/nft/asset/traits ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy Expand all Collapse all `{ * "rank": 51, * "traits": [ * { * "category": "background", * "name": "red", * "price": 100, * "rarity": 0.4 } ] }` [](https://openapi.taptools.io/#tag/Market-NFTs/paths/~1nft~1collection~1assets/get) Collection assets ------------------------------------------------------------------------------------------------------ Get all NFTs from a collection with the ability to sort by price/rank and filter to specific traits. Categories and traits can be searched for by adding query params ex:(`policy=abc&hair=white,black&background=red`), you can have any combination of categories and traits ex:(`policy=abc&hair=blonde&background=blue`) ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | policy

required | string

Example: policy=40fa2aa67258b4ce7b5782f74831d46a84c59a0ff0c28262fab21728

The policy ID for the collection. | | sortBy | string

Example: sortBy=price

What should the results be sorted by. Options are `price` and `rank`. Default is `price`. | | order | string

Example: order=asc

Which direction should the results be sorted. Options are `asc`, `desc`. Default is `asc` | | search | string

Example: search=ClayNation3725

Search for a certain NFT's name, default is `null`. | | onSale | string

Example: onSale=1

Return only nfts that are on sale Options are `0`, `1`. Default is `0`. | | page | integer

Example: page=1

This endpoint supports pagination. Default page is `1`. | | perPage | integer

Example: perPage=100

Specify how many items to return per page. Maximum is `100`, default is `100`. | ### Responses **200** Collection assets. **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/nft/collection/assets TapTools OpenAPI https://openapi.taptools.io/api/v1/nft/collection/assets ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy Expand all Collapse all `[ * { * "image": "ipfs://QmeDi3J1exQYnGAuwZv7b6sAuDBAo2hYdAMM1KGgS7KFa4", * "name": "ClayNation3725", * "price": 20, * "rank": 2 } ]` [](https://openapi.taptools.io/#tag/Market-NFTs/paths/~1nft~1collection~1holders~1distribution/get) Holder distribution ----------------------------------------------------------------------------------------------------------------------- Get the distribution of NFTs within a collection by bucketing into number of NFTs held groups. This counts someone who has an asset listed on a marketplace as an owner, as well as someone who is staking their NFT to a supported smart contract. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | policy

required | string

Example: policy=40fa2aa67258b4ce7b5782f74831d46a84c59a0ff0c28262fab21728

The policy ID for the collection. | ### Responses **200** Collection holder distribution **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/nft/collection/holders/distribution TapTools OpenAPI https://openapi.taptools.io/api/v1/nft/collection/holders/distribution ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy `{ * "1": 1154, * "10-24": 60, * "2-4": 631, * "25+": 2, * "5-9": 327 }` [](https://openapi.taptools.io/#tag/Market-NFTs/paths/~1nft~1collection~1holders~1top/get) Top holders ------------------------------------------------------------------------------------------------------ Get the top holders for a particular NFT collection. This counts someone who has an asset listed on a marketplace as an owner, as well as someone who is staking their NFT to a supported smart contract. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | policy

required | string

Example: policy=40fa2aa67258b4ce7b5782f74831d46a84c59a0ff0c28262fab21728

The policy ID for the collection. | | page | integer

Example: page=1

This endpoint supports pagination. Default page is `1`. | | perPage | integer

Example: perPage=10

Specify how many items to return per page. Maximum is `100`, default is `10`. | | excludeExchanges | integer

Example: excludeExchanges=1

Whether or not to exclude marketplace addresses (0, 1) | ### Responses **200** Collection top holders **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/nft/collection/holders/top TapTools OpenAPI https://openapi.taptools.io/api/v1/nft/collection/holders/top ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy Expand all Collapse all `[ * { * "address": "stake1u8mvwfn298a4dkm92hrgeupnnuzhxfwl5lauzuejl5cf8esrtjn6w", * "amount": 27 } ]` [](https://openapi.taptools.io/#tag/Market-NFTs/paths/~1nft~1collection~1holders~1trended/get) Trended holders -------------------------------------------------------------------------------------------------------------- Get holders trended by day for a particular NFT collection. This counts someone who has an asset listed on a marketplace as an owner, as well as someone who is staking their NFT to a supported smart contract. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | policy

required | string

Example: policy=40fa2aa67258b4ce7b5782f74831d46a84c59a0ff0c28262fab21728

The policy ID for the collection. | | timeframe | string

Example: timeframe=30d

The time interval. Options are `7d`, `30d`, `90d`, `180d`, `1y` and `all`. Defaults to `30d`. | ### Responses **200** Collection trended holders **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/nft/collection/holders/trended TapTools OpenAPI https://openapi.taptools.io/api/v1/nft/collection/holders/trended ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy Expand all Collapse all `[ * { * "holders": 3125, * "time": 1705874400 } ]` [](https://openapi.taptools.io/#tag/Market-NFTs/paths/~1nft~1collection~1info/get) Collection info -------------------------------------------------------------------------------------------------- Get basic information about a collection like name, socials, and logo. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | policy

required | string

Example: policy=1fcf4baf8e7465504e115dcea4db6da1f7bed335f2a672e44ec3f94e

The policy ID for the collection. | ### Responses **200** Collection info **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/nft/collection/info TapTools OpenAPI https://openapi.taptools.io/api/v1/nft/collection/info ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy `{ * "description": "The Ape Society is a collection of 7,000 NFTs generated on the Cardano blockchain.", * "discord": "[https://discord.gg/theapesociety](https://discord.gg/theapesociety) ", * "logo": "ipfs://QmVT8QGerKMLaJkxdUqefw7V7fjccGgcKjLnbMavisELsf", * "name": "The Ape Society", * "supply": 10000, * "twitter": "[https://twitter.com/the_ape_society](https://twitter.com/the_ape_society) ", * "website": "[https://www.theapesociety.io/](https://www.theapesociety.io/) " }` [](https://openapi.taptools.io/#tag/Market-NFTs/paths/~1nft~1collection~1listings/get) Number of active listings ---------------------------------------------------------------------------------------------------------------- Get the amount of active listings along with total supply for a particular collection. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | policy

required | string

Example: policy=1fcf4baf8e7465504e115dcea4db6da1f7bed335f2a672e44ec3f94e

The policy ID for the collection. | ### Responses **200** Current active listings **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/nft/collection/listings TapTools OpenAPI https://openapi.taptools.io/api/v1/nft/collection/listings ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy `{ * "listings": 168, * "supply": 1000 }` [](https://openapi.taptools.io/#tag/Market-NFTs/paths/~1nft~1collection~1listings~1depth/get) NFT listings depth ---------------------------------------------------------------------------------------------------------------- Get cumulative amount of listings at each price point, starting at the floor and moving upwards. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | policy

required | string

Example: policy=1fcf4baf8e7465504e115dcea4db6da1f7bed335f2a672e44ec3f94e

The policy ID for the collection. | | items | integer

Example: items=600

Specify how many items to return. Maximum is `1000`, default is `500`. | ### Responses **200** NFT collection listings depth **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/nft/collection/listings/depth TapTools OpenAPI https://openapi.taptools.io/api/v1/nft/collection/listings/depth ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy Expand all Collapse all `[ * { * "avg": 4850, * "count": 96, * "price": 9600, * "total": 456000 } ]` [](https://openapi.taptools.io/#tag/Market-NFTs/paths/~1nft~1collection~1listings~1individual/get) Get list of active listings ------------------------------------------------------------------------------------------------------------------------------ Get a list of active listings with supporting information. This endpoint supports pagination and sorting by price and time listed. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | policy

required | string

Example: policy=1fcf4baf8e7465504e115dcea4db6da1f7bed335f2a672e44ec3f94e

The policy ID for the collection. | | sortBy | string

Example: sortBy=price

What should the results be sorted by. Options are `price`, `time`. Default is `price`. | | order | string

Example: order=asc

Which direction should the results be sorted. Options are `asc`, `desc`. Default is `asc` | | page | integer

Example: page=1

This endpoint supports pagination. Default page is `1`. | | perPage | integer

Example: perPage=100

Specify how many items to return per page. Maximum is `100`, default is `100`. | ### Responses **200** NFT collection listings **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/nft/collection/listings/individual TapTools OpenAPI https://openapi.taptools.io/api/v1/nft/collection/listings/individual ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy Expand all Collapse all `[ * { * "image": "ipfs://QmdnZKmDWd85BLKfsHnrJExRKE71zPGawwy7jWhc2wBwmM", * "market": "jpg.store", * "name": "ClayNation3725", * "price": 4925, * "time": 1680135943 } ]` [](https://openapi.taptools.io/#tag/Market-NFTs/paths/~1nft~1collection~1listings~1trended/get) NFT listings trended -------------------------------------------------------------------------------------------------------------------- Get trended number of listings and floor price for a particular NFT collection. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | policy

required | string

Example: policy=1fcf4baf8e7465504e115dcea4db6da1f7bed335f2a672e44ec3f94e

The policy ID for the collection. | | interval

required | string

Example: interval=1d

The time interval. Options are `3m`, `5m`, `15m`, `30m`, `1h`, `2h`, `4h`, `12h`, `1d`, `3d`, `1w`, `1M`. | | numIntervals | integer

Example: numIntervals=180

The number of intervals to return, e.g. if you want 180 days of data in 1d intervals, then pass `180` here. Leave blank for full history. | ### Responses **200** NFT collection trended listings **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/nft/collection/listings/trended TapTools OpenAPI https://openapi.taptools.io/api/v1/nft/collection/listings/trended ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy Expand all Collapse all `[ * { * "listings": 592, * "price": 205, * "time": 1680574100 } ]` [](https://openapi.taptools.io/#tag/Market-NFTs/paths/~1nft~1collection~1ohlcv/get) NFT floor price OHLCV --------------------------------------------------------------------------------------------------------- Get OHLCV (open, high, low, close, volume) of floor price for a particular NFT collection. If you don't plan to format with candlesticks, you can use the `close` value from each interval and create a simple line chart. `time` is the start time of the interval, as a UNIX timestamp. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | policy

required | string

Example: policy=1fcf4baf8e7465504e115dcea4db6da1f7bed335f2a672e44ec3f94e

The policy ID for the collection. | | interval

required | string

Example: interval=1d

The time interval. Options are `3m`, `5m`, `15m`, `30m`, `1h`, `2h`, `4h`, `12h`, `1d`, `3d`, `1w`, `1M`. | | numIntervals | integer

Example: numIntervals=180

The number of intervals to return, e.g. if you want 180 days of data in 1d intervals, then pass `180` here. | | quote | string

Example: quote=ada

Quote currency to use, e.g. `USD`, `EUR`, `ADA`. Defaults to `ADA`. Check `/token/quote/available` for available options. | ### Responses **200** NFT collection OHLCV **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/nft/collection/ohlcv TapTools OpenAPI https://openapi.taptools.io/api/v1/nft/collection/ohlcv ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy Expand all Collapse all `[ * { * "close": 4150, * "high": 4150, * "low": 3950, * "open": 4000, * "time": 1680574100, * "volume": 61480 } ]` [](https://openapi.taptools.io/#tag/Market-NFTs/paths/~1nft~1collection~1stats/get) Collection stats ---------------------------------------------------------------------------------------------------- Get basic information about a collection like floor price, volume, and supply. Volume returned is lifetime volume. Use `/nft/collection/trades/stats` for different timeframes and more information about trading volume. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | policy

required | string

Example: policy=1fcf4baf8e7465504e115dcea4db6da1f7bed335f2a672e44ec3f94e

The policy ID for the collection. | ### Responses **200** Collection stats **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/nft/collection/stats TapTools OpenAPI https://openapi.taptools.io/api/v1/nft/collection/stats ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy `{ * "listings": 673, * "owners": 1124, * "price": 450, * "sales": 4782, * "supply": 10000, * "topOffer": 400, * "volume": 16844521 }` [](https://openapi.taptools.io/#tag/Market-NFTs/paths/~1nft~1collection~1stats~1extended/get) Collection stats (extended) ------------------------------------------------------------------------------------------------------------------------- Get basic information about a collection like floor price, volume, and supply. Volume returned is lifetime volume. `pctChg` values are the percentage difference between current values and value up until timeframe. This returns the same data as `nft/collection/stats`, but with percent changes included. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | policy

required | string

Example: policy=1fcf4baf8e7465504e115dcea4db6da1f7bed335f2a672e44ec3f94e

The policy ID for the collection. | | timeframe | string

Example: timeframe=24h

The time interval. Options are `24h`, `7d`, `30d`. Defaults to `24h`. | ### Responses **200** NFT collection extended stats **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/nft/collection/stats/extended TapTools OpenAPI https://openapi.taptools.io/api/v1/nft/collection/stats/extended ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy `{ * "listings": 673, * "listingsPctChg": 0.11, * "owners": 1124, * "ownersPctChg": 0.05, * "price": 450, * "pricePctChg": 0.024, * "sales": 5431, * "salesPctChg": 0.008, * "supply": 10000, * "topOffer": 380, * "volume": 16844521, * "volumePctChg": 0.014 }` [](https://openapi.taptools.io/#tag/Market-NFTs/paths/~1nft~1collection~1trades/get) Trades ------------------------------------------------------------------------------------------- Get individual trades for a particular collection or for the entire NFT market by not specifying a policy ID. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | policy | string

Example: policy=1fcf4baf8e7465504e115dcea4db6da1f7bed335f2a672e44ec3f94e

The policy ID for the collection. | | timeframe | string

Example: timeframe=30d

The time interval. Options are `1h`, `4h`, `24h`, `7d`, `30d`, `90d`, `180d`, `1y`, `all`. Defaults to `30d`. | | sortBy | string

Example: sortBy=time

What should the results be sorted by. Options are `amount`, `time`. Default is `time`. | | order | string

Example: order=desc

Which direction should the results be sorted. Options are `asc`, `desc`. Default is `desc`. | | minAmount | integer

Example: minAmount=1000

Filter to only trades of a certain ADA amount. | | from | integer

Example: from=1704759422

Filter trades using a UNIX timestamp, will only return trades after this timestamp. | | page | integer

Example: page=1

This endpoint supports pagination. Default page is `1`. | | perPage | integer

Example: perPage=100

Specify how many items to return per page. Maximum is `100`, default is `100`. | ### Responses **200** Individual trades **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/nft/collection/trades TapTools OpenAPI https://openapi.taptools.io/api/v1/nft/collection/trades ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy Expand all Collapse all `[ * { * "buyerAddress": "addr1qxvpuw8dmmwvzs4lvjmuamn7l748n9wuvrumuz27v8mt6kzktn257cny8gcw0f99ft99apqdakca6grf9stpptjdyevqffsm7e", * "collectionName": "Clay Nation", * "hash": "505cb5a55f7bbe0ed70e58d97b105220ea662fb91bbd89e915ca85f07500a9b9", * "image": "ipfs://QmdnZKmDWd85BLKfsHnrJExRKE71zPGawwy7jWhc2wBwmM", * "market": "jpg.store", * "name": "ClayNation3725", * "policy": "40fa2aa67258b4ce7b5782f74831d46a84c59a0ff0c28262fab21728", * "price": 4925, * "sellerAddress": "addr1q9wmpjmp767fewhqswq89lua7csns8a704hrjljdt5r40ssstt62h0erkvx72zarcydnlldp0sj0ml02w3k06r8mpy8qm8eqkf", * "time": 1680135943 } ]` [](https://openapi.taptools.io/#tag/Market-NFTs/paths/~1nft~1collection~1trades~1stats/get) Trading stats --------------------------------------------------------------------------------------------------------- Get trading stats like volume and number of sales for a particular collection. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | policy

required | string

Example: policy=1fcf4baf8e7465504e115dcea4db6da1f7bed335f2a672e44ec3f94e

The policy ID for the collection. | | timeframe | string

Example: timeframe=24h

What timeframe to include in volume aggregation. Options are `1h`, `4h`, `24h`, `7d`, `30d`, `all`. Defaults to `24h`. | ### Responses **200** Amount of trading volume **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/nft/collection/trades/stats TapTools OpenAPI https://openapi.taptools.io/api/v1/nft/collection/trades/stats ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy `{ * "buyers": 35, * "sales": 42, * "sellers": 16, * "volume": 247521 }` [](https://openapi.taptools.io/#tag/Market-NFTs/paths/~1nft~1collection~1traits~1price/get) Collection trait prices ------------------------------------------------------------------------------------------------------------------- Get a list of traits within a collection and each trait's floor price. This allows you to see which traits are higher/lower priced. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | policy

required | string

Example: policy=40fa2aa67258b4ce7b5782f74831d46a84c59a0ff0c28262fab21728

The policy ID for the collection. | | name | string

Example: name=ClayNation3725

The name of a specific NFT to get trait prices for. | ### Responses **200** Collection trait prices **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/nft/collection/traits/price TapTools OpenAPI https://openapi.taptools.io/api/v1/nft/collection/traits/price ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy Expand all Collapse all `{ * "background": { * "blue": 5, * "red": 8 }, * "hair": { * "black": 10, * "blonde": 30 } }` [](https://openapi.taptools.io/#tag/Market-NFTs/paths/~1nft~1collection~1traits~1rarity/get) Collection metadata rarity ----------------------------------------------------------------------------------------------------------------------- Get every metadata attribute and how likely it is to occur within the NFT collection. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | policy

required | string

Example: policy=1fcf4baf8e7465504e115dcea4db6da1f7bed335f2a672e44ec3f94e

The policy ID for the collection. | ### Responses **200** Collection metadata rarity **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/nft/collection/traits/rarity TapTools OpenAPI https://openapi.taptools.io/api/v1/nft/collection/traits/rarity ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy Expand all Collapse all `{ * "Accessories": { * "Bowtie": 0.0709, * "Collar": 0.1184 }, * "Background": { * "Cyan": 0.1316, * "Lilac": 0.147 } }` [](https://openapi.taptools.io/#tag/Market-NFTs/paths/~1nft~1collection~1traits~1rarity~1rank/get) NFT rarity rank ------------------------------------------------------------------------------------------------------------------ Get rank of NFT's rarity within a collection ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | policy

required | string

Example: policy=40fa2aa67258b4ce7b5782f74831d46a84c59a0ff0c28262fab21728

The policy ID for the collection. | | name

required | string

Example: name=ClayNation3725

The name of the NFT | ### Responses **200** NFT rarity rank **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/nft/collection/traits/rarity/rank TapTools OpenAPI https://openapi.taptools.io/api/v1/nft/collection/traits/rarity/rank ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy `{ * "rank": 7346 }` [](https://openapi.taptools.io/#tag/Market-NFTs/paths/~1nft~1collection~1volume~1trended/get) NFT volume trended ---------------------------------------------------------------------------------------------------------------- Get trended volume and number of sales for a particular NFT collection. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | policy

required | string

Example: policy=1fcf4baf8e7465504e115dcea4db6da1f7bed335f2a672e44ec3f94e

The policy ID for the collection. | | interval

required | string

Example: interval=1d

The time interval. Options are `3m`, `5m`, `15m`, `30m`, `1h`, `2h`, `4h`, `12h`, `1d`, `3d`, `1w`, `1M`. | | numIntervals | integer

Example: numIntervals=180

The number of intervals to return, e.g. if you want 180 days of data in 1d intervals, then pass `180` here. Leave blank for full history. | ### Responses **200** NFT collection trended volume **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/nft/collection/volume/trended TapTools OpenAPI https://openapi.taptools.io/api/v1/nft/collection/volume/trended ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy Expand all Collapse all `[ * { * "price": 205, * "sales": 153, * "time": 1680574100, * "volume": 12034 } ]` [](https://openapi.taptools.io/#tag/Market-NFTs/paths/~1nft~1market~1stats/get) Market-wide NFT stats ----------------------------------------------------------------------------------------------------- Get high-level market stats across the entire NFT market. `addresses` is the count of stake keys that have purchased or sold an NFT within the given timeframe. If an address does not have a stake key, it is still counted as a distinct address. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | timeframe

required | string

Example: timeframe=1d

The time interval. Options are `1h`, `4h`, `24h`, `7d`, `30d`, `all`. Defaults to `24h`. | ### Responses **200** NFT market stats **400** Bad Request **401** Not Authorized **429** Rate Limit Exceeded **500** Interval Server Error get/nft/market/stats TapTools OpenAPI https://openapi.taptools.io/api/v1/nft/market/stats ### Response samples * 200 * 400 * 401 * 429 * 500 Content type application/json Copy `{ * "addresses": 5321, * "buyers": 3451, * "sales": 7832, * "sellers": 3110, * "volume": 876345 }` [](https://openapi.taptools.io/#tag/Market-NFTs/paths/~1nft~1market~1stats~1extended/get) Market-wide NFT stats (extended) -------------------------------------------------------------------------------------------------------------------------- Get high-level market stats across the entire NFT market. `addresses` is the count of stake keys that have purchased or sold an NFT within the given timeframe. If an address does not have a stake key, it is still counted as a distinct address. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | timeframe

required | string

Example: timeframe=1d

The time interval. Options are `1h`, `4h`, `24h`, `7d`, `30d`, `all`. Defaults to `24h`. | ### Responses **200** NFT market stats **400** Bad Request **401** Not Authorized **429** Rate Limit Exceeded **500** Interval Server Error get/nft/market/stats/extended TapTools OpenAPI https://openapi.taptools.io/api/v1/nft/market/stats/extended ### Response samples * 200 * 400 * 401 * 429 * 500 Content type application/json Copy `{ * "addresses": 5321, * "addressesPctChg": -0.11, * "buyers": 3451, * "buyersPctChg": 0.08, * "sales": 7832, * "salesPctChg": 0.02, * "sellers": 3110, * "sellersPctChg": -0.15, * "volume": 876345, * "volumePctChg": 0.08 }` [](https://openapi.taptools.io/#tag/Market-NFTs/paths/~1nft~1market~1volume~1trended/get) NFT market volume ----------------------------------------------------------------------------------------------------------- Get trended volume for entire NFT market. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | timeframe

required | string

Example: timeframe=30d

The time interval. Options are `7d`, `30d`, `90d`, `180d`, `1y`, `all`. Defaults to `30d`. | ### Responses **200** NFT market volume trended **400** Bad Request **401** Not Authorized **429** Rate Limit Exceeded **500** Interval Server Error get/nft/market/volume/trended TapTools OpenAPI https://openapi.taptools.io/api/v1/nft/market/volume/trended ### Response samples * 200 * 400 * 401 * 429 * 500 Content type application/json Copy Expand all Collapse all `[ * { * "time": 1690171200, * "value": 783125 } ]` [](https://openapi.taptools.io/#tag/Market-NFTs/paths/~1nft~1marketplace~1stats/get) NFT Marketplace stats ---------------------------------------------------------------------------------------------------------- Get high-level NFT marketplace stats. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | timeframe | string

Example: timeframe=30d

The time interval. Options are `24h`, `7d`, `30d`, `90d`, `180d`, `all`. Defaults to `7d`. | | marketplace | string

Example: marketplace=jpg.store

Filters data to a certain marketplace by name. | | lastDay | integer

Example: lastDay=0

Filters to only count data that occured between yesterday 00:00UTC and today 00:00UTC `(0,1)`. | ### Responses **200** NFT marketplace stats **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/nft/marketplace/stats TapTools OpenAPI https://openapi.taptools.io/api/v1/nft/marketplace/stats ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy Expand all Collapse all `[ * { * "avgSale": 100.5, * "fees": 41210.512, * "liquidity": 14341.1231, * "listings": 300, * "name": "jpg.store", * "royalties": 645432.3123, * "sales": 7832, * "users": 5321, * "volume": 876345.312 } ]` [](https://openapi.taptools.io/#tag/Market-NFTs/paths/~1nft~1top~1timeframe/get) NFT top rankings ------------------------------------------------------------------------------------------------- Get top NFT rankings based on total market cap, 24 hour volume or 24 hour top price gainers/losers. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | ranking

required | string

Example: ranking=marketCap

Criteria to rank NFT Collections based on. Options are `marketCap`, `volume`, `gainers`, `losers`. | | items | integer

Example: items=50

Specify how many items to return. Maximum is `100`, default is `25`. | ### Responses **200** NFT Top Rankings. **400** Bad Request **401** Not Authorized **404** Not Found **406** Not acceptable **429** Rate Limit Exceeded **500** Interval Server Error get/nft/top/timeframe TapTools OpenAPI https://openapi.taptools.io/api/v1/nft/top/timeframe ### Response samples * 200 * 400 * 401 * 404 * 406 * 429 * 500 Content type application/json Copy Expand all Collapse all `[ * { * "listings": 15, * "logo": "[https://linktologo4.com](https://linktologo4.com/) ", * "marketCap": 25000, * "name": "testCollection4", * "policy": "e3ff4ab89245ede61b3e2beab0443dbcc7ea8ca2c017478e4e8990e2", * "price": 500, * "price24hChg": 0.5, * "price30dChg": 0.7, * "price7dChg": 0.6, * "rank": 1, * "supply": 50, * "volume24h": 4000, * "volume24hChg": 0.11, * "volume30d": 6000, * "volume30dChg": 0.05, * "volume7d": 5000, * "volume7dChg": -0.11 } ]` [](https://openapi.taptools.io/#tag/Market-NFTs/paths/~1nft~1top~1volume/get) Top volume collections ---------------------------------------------------------------------------------------------------- Get top NFT collections by trading volume over a given timeframe. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | timeframe | string

Example: timeframe=24h

What timeframe to include in volume aggregation. Options are `1h`, `4h`, `24h`, `7d`, `30d`, `all`. Defaults to `24h`. | | page | integer

Example: page=1

This endpoint supports pagination. Default page is `1`. | | perPage | integer

Example: perPage=10

Specify how many items to return per page. Maximum is `100`, default is `10`. | ### Responses **200** Top NFT collections by volume **400** Bad Request **401** Not Authorized **429** Rate Limit Exceeded **500** Interval Server Error get/nft/top/volume TapTools OpenAPI https://openapi.taptools.io/api/v1/nft/top/volume ### Response samples * 200 * 400 * 401 * 429 * 500 Content type application/json Copy `{ * "listings": 583, * "logo": "ipfs://QmZ3mjsA4YL58HZQ6pxhAp1EaibmTi15uzTNAmDekZDzNf", * "name": "Stag Alliance", * "policy": "1fcf4baf8e7465504e115dcea4db6da1f7bed335f2a672e44ec3f94e", * "price": 175, * "sales": 215, * "supply": 7200, * "volume": 49606 }` [](https://openapi.taptools.io/#tag/Market-NFTs/paths/~1nft~1top~1volume~1extended/get) Top volume collections (extended) ------------------------------------------------------------------------------------------------------------------------- Get top NFT collections by trading volume over a given timeframe. `pctChg` values are the percentage difference between current values and values up until the given `timeframe`. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | timeframe | string

Example: timeframe=24h

What timeframe to include in volume aggregation. Options are `1h`, `4h`, `24h`, `7d`, `30d`, `all`. Defaults to `24h`. | | page | integer

Example: page=1

This endpoint supports pagination. Default page is `1`. | | perPage | integer

Example: perPage=10

Specify how many items to return per page. Maximum is `100`, default is `10`. | ### Responses **200** Top NFT collections by volume **400** Bad Request **401** Not Authorized **429** Rate Limit Exceeded **500** Interval Server Error get/nft/top/volume/extended TapTools OpenAPI https://openapi.taptools.io/api/v1/nft/top/volume/extended ### Response samples * 200 * 400 * 401 * 429 * 500 Content type application/json Copy `{ * "listings": 583, * "listingsPctChg": 0.11, * "logo": "ipfs://QmZ3mjsA4YL58HZQ6pxhAp1EaibmTi15uzTNAmDekZDzNf", * "name": "Stag Alliance", * "owners": 542, * "ownersPctChg": -0.031, * "policy": "1fcf4baf8e7465504e115dcea4db6da1f7bed335f2a672e44ec3f94e", * "price": 175, * "pricePctChg": 0.024, * "sales": 50, * "salesPctChg": 0.34, * "supply": 7200, * "volume": 49606, * "volumePctChg": 0.014 }` [](https://openapi.taptools.io/#tag/Market-Tokens) Market » Tokens ------------------------------------------------------------------ [](https://openapi.taptools.io/#tag/Market-Tokens/paths/~1token~1debt~1loans/get) Active loans ---------------------------------------------------------------------------------------------- Get active P2P loans of a certain token (Currently only supports P2P protocols like Lenfi and Levvy). ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | unit

required | string

Example: unit=8fef2d34078659493ce161a6c7fba4b56afefa8535296a5743f6958741414441

Token unit (policy + hex name) to filter by | | include | string

Example: include=collateral,debt

Comma seperated value enabling you to filter to loans where token is used as `collateral`, `debt`, `interest` or a mix of them, default is `collateral,debt` filtering to loans where token is used as collateral OR debt. | | sortBy | string

Example: sortBy=time

What should the results be sorted by. Options are `time`, `expiration`. Default is `time`. `expiration` is expiration date of loan. | | order | string

Example: order=desc

Which direction should the results be sorted. Options are `asc`, `desc`. Default is `desc`. | | page | integer

Example: page=1

This endpoint supports pagination. Default page is `1`. | | perPage | integer

Example: perPage=100

Specify how many items to return per page, default is `100`. | ### Responses **200** P2P loans successfully returned **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/token/debt/loans TapTools OpenAPI https://openapi.taptools.io/api/v1/token/debt/loans ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy Expand all Collapse all `[ * { * "collateralAmount": 120.131, * "collateralToken": "b46b12f0a61721a0358988f806a7c1562e1e622d5886a73194051f336d6131", * "collateralValue": 84.466, * "debtAmount": 100, * "debtToken": "b46b12f0a61721a0358988f806a7c1562e1e622d5886a73194051f336d6131", * "debtValue": 70.3123, * "expiration": 1722995180, * "hash": "0002464b78a10d0a0dc6345666764caf519befa28d2ccb2efc711376320d54ef", * "health": 1.172, * "interestAmount": 2.131, * "interestToken": "b46b12f0a61721a0358988f806a7c1562e1e622d5886a73194051f336d6131", * "interestValue": 1.75, * "protocol": "Levvy", * "time": 1721908780 } ]` [](https://openapi.taptools.io/#tag/Market-Tokens/paths/~1token~1debt~1offers/get) Loan offers ---------------------------------------------------------------------------------------------- Get active P2P loan offers that are not associated with any loans yet (Currently only supports P2P protocols like Lenfi and Levvy). ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | unit

required | string

Example: unit=8fef2d34078659493ce161a6c7fba4b56afefa8535296a5743f6958741414441

Token unit (policy + hex name) to filter by | | include | string

Example: include=collateral,debt

Comma seperated value enabling you to filter to offers where token is used as `collateral`, `debt`, `interest` or a mix of them, default is `collateral,debt` filtering to offers where token is used as collateral OR debt. | | sortBy | string

Example: sortBy=time

What should the results be sorted by. Options are `time`, `duration`. Default is `time`. `duration` is loan duration in seconds. | | order | string

Example: order=desc

Which direction should the results be sorted. Options are `asc`, `desc`. Default is `desc`. | | page | integer

Example: page=1

This endpoint supports pagination. Default page is `1`. | | perPage | integer

Example: perPage=100

Specify how many items to return per page, default is `100`. | ### Responses **200** P2P offers successfully returned **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/token/debt/offers TapTools OpenAPI https://openapi.taptools.io/api/v1/token/debt/offers ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy Expand all Collapse all `[ * { * "collateralAmount": 120.131, * "collateralToken": "b46b12f0a61721a0358988f806a7c1562e1e622d5886a73194051f336d6131", * "collateralValue": 84.466, * "debtAmount": 100, * "debtToken": "b46b12f0a61721a0358988f806a7c1562e1e622d5886a73194051f336d6131", * "debtValue": 70.3123, * "duration": 1209600, * "hash": "0002464b78a10d0a0dc6345666764caf519befa28d2ccb2efc711376320d54ef", * "health": 1.172, * "interestAmount": 2.131, * "interestToken": "b46b12f0a61721a0358988f806a7c1562e1e622d5886a73194051f336d6131", * "interestValue": 1.75, * "protocol": "Levvy", * "time": 1692781200 } ]` [](https://openapi.taptools.io/#tag/Market-Tokens/paths/~1token~1holders/get) Token holders ------------------------------------------------------------------------------------------- Get total number of holders for a specific token. This uses `coalesce(stake_address, address)`, so all addresses under one stake key will be aggregated into 1 holder. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | unit

required | string

Example: unit=8fef2d34078659493ce161a6c7fba4b56afefa8535296a5743f6958741414441

Token unit (policy + hex name) | ### Responses **200** Holders successfully returned **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/token/holders TapTools OpenAPI https://openapi.taptools.io/api/v1/token/holders ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy `{ * "holders": 1024 }` [](https://openapi.taptools.io/#tag/Market-Tokens/paths/~1token~1holders~1top/get) Top token holders ---------------------------------------------------------------------------------------------------- Get top token holders. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | unit

required | string

Example: unit=8fef2d34078659493ce161a6c7fba4b56afefa8535296a5743f6958741414441

Token unit (policy + hex name) | | page | integer

Example: page=1

This endpoint supports pagination. Default page is `1`. | | perPage | integer

Example: perPage=20

Specify how many items to return per page. Maximum is `100`, default is `20`. | ### Responses **200** Top holders successfully returned **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/token/holders/top TapTools OpenAPI https://openapi.taptools.io/api/v1/token/holders/top ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy Expand all Collapse all `[ * { * "address": "stake1uyqj8nukxpcal7h6zdjr958wfk5yhqcns2ard8c7appyd0gt06k67", * "amount": 13432.34 } ]` [](https://openapi.taptools.io/#tag/Market-Tokens/paths/~1token~1indicators/get) Token price indicators ------------------------------------------------------------------------------------------------------- Get indicator values (e.g. EMA, RSI) based on price data for a specific token. There are multiple parameters that can be passed, but some only apply to certain indicators. This will return the most recent values. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | unit

required | string

Example: unit=8fef2d34078659493ce161a6c7fba4b56afefa8535296a5743f6958741414441

Token unit (policy + hex name) | | interval

required | string

Example: interval=1d

The time interval. Options are `3m`, `5m`, `15m`, `30m`, `1h`, `2h`, `4h`, `12h`, `1d`, `3d`, `1w`, `1M`. | | items | integer

Example: items=100

The number of items to return. The maximum number of items that can be returned is 1000. | | indicator | string

Example: indicator=ma

Specify which indicator to use. Options are `ma`, `ema`, `rsi`, `macd`, `bb`, `bbw`. | | length | integer

Example: length=14

Length of data to include. Used in `ma`, `ema`, `rsi`, `bb`, and `bbw`. | | smoothingFactor | integer

Example: smoothingFactor=2

Length of data to include for smoothing. Used in `ema`. Most often is set to 2. | | fastLength | integer

Example: fastLength=12

Length of shorter EMA to use in MACD. Only used in `macd` | | slowLength | integer

Example: slowLength=26

Length of longer EMA to use in MACD. Only used in `macd` | | signalLength | integer

Example: signalLength=9

Length of signal EMA to use in MACD. Only used in `macd` | | stdMult | integer

Example: stdMult=2

Standard deviation multiplier to use for upper and lower bands of Bollinger Bands (typically set to 2). Used in `bb` and `bbw`. | | quote | string

Example: quote=ADA

Which quote currency to use when building price data (e.g. `ADA`, `USD`). | ### Responses **200** Token indicator values successfully returned **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/token/indicators TapTools OpenAPI https://openapi.taptools.io/api/v1/token/indicators ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy `[ * 2.33521 ]` [](https://openapi.taptools.io/#tag/Market-Tokens/paths/~1token~1links/get) Token links --------------------------------------------------------------------------------------- Get a specific token's social links, if they have been provided to TapTools. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | unit

required | string

Example: unit=8fef2d34078659493ce161a6c7fba4b56afefa8535296a5743f6958741414441

Token unit (policy + hex name) | ### Responses **200** Token links **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/token/links TapTools OpenAPI https://openapi.taptools.io/api/v1/token/links ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy `{ * "description": "LENFI is a utility token integral to a decentralized lending and borrowing protocol on the Cardano blockchain", * "discord": "[https://discord.gg/lenfi](https://discord.gg/lenfi) ", * "email": "project@gmail.com", * "facebook": "[https://www.facebook.com/WorldMobileTeam/](https://www.facebook.com/WorldMobileTeam/) ", * "github": "[https://github.com/lenfiLabs](https://github.com/lenfiLabs) ", * "instagram": "[https://www.instagram.com/WorldMobileTeam/](https://www.instagram.com/WorldMobileTeam/) ", * "medium": "string", * "reddit": "[https://www.reddit.com/r/worldmobile/](https://www.reddit.com/r/worldmobile/) ", * "telegram": "[http://t.me/lenfi](http://t.me/lenfi) ", * "twitter": "[https://twitter.com/LenfiOfficial](https://twitter.com/LenfiOfficial) ", * "website": "[https://lenfi.io](https://lenfi.io/) ", * "youtube": "[https://www.youtube.com/@WorldMobileTeam](https://www.youtube.com/@WorldMobileTeam) " }` [](https://openapi.taptools.io/#tag/Market-Tokens/paths/~1token~1mcap/get) Token market cap ------------------------------------------------------------------------------------------- Get a specific token's supply and market cap information. We pull circulating supply information from [this repo](https://github.com/minswap/market-cap) . ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | unit

required | string

Example: unit=8fef2d34078659493ce161a6c7fba4b56afefa8535296a5743f6958741414441

Token unit (policy + hex name) | ### Responses **200** Supply and market cap successfully returned **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/token/mcap TapTools OpenAPI https://openapi.taptools.io/api/v1/token/mcap ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy `{ * "circSupply": 1036194689.027126, * "fdv": 184018358.12, * "mcap": 63559615.43, * "price": 0.0613, * "ticker": "MIN", * "totalSupply": 3000000000 }` [](https://openapi.taptools.io/#tag/Market-Tokens/paths/~1token~1ohlcv/get) Token price OHLCV --------------------------------------------------------------------------------------------- Get a specific token's trended (`open`, `high`, `low`, `close`, `volume`) price data. You can either pass a token unit to get aggregated data across all liquidity pools, or an `onchainID` for a specific pair (see `/token/pools`). ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | unit | string

Example: unit=8fef2d34078659493ce161a6c7fba4b56afefa8535296a5743f6958741414441

Token unit (policy + hex name) | | onchainID | string

Example: onchainID=0be55d262b29f564998ff81efe21bdc0022621c12f15af08d0f2ddb1.39b9b709ac8605fc82116a2efc308181ba297c11950f0f350001e28f0e50868b

Pair onchain ID to get ohlc data for | | interval

required | string

Example: interval=1d

The time interval. Options are `3m`, `5m`, `15m`, `30m`, `1h`, `2h`, `4h`, `12h`, `1d`, `3d`, `1w`, `1M`. | | numIntervals | integer

Example: numIntervals=180

The number of intervals to return, e.g. if you want 180 days of data in 1d intervals, then pass `180` here. | ### Responses **200** Token ohlcv data successfully returned **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/token/ohlcv TapTools OpenAPI https://openapi.taptools.io/api/v1/token/ohlcv ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy Expand all Collapse all `[ * { * "close": 1.33, * "high": 1.38, * "low": 1.33, * "open": 1.34, * "time": 1692738000, * "volume": 103432.3324 } ]` [](https://openapi.taptools.io/#tag/Market-Tokens/paths/~1token~1pools/get) Token liquidity pools ------------------------------------------------------------------------------------------------- Get a specific token's active liquidity pools. Can search for all token pools using `unit` or can search for specific pool with `onchainID`. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | unit | string

Example: unit=8fef2d34078659493ce161a6c7fba4b56afefa8535296a5743f6958741414441

Token unit (policy + hex name) | | onchainID | string

Example: onchainID=0be55d262b29f564998ff81efe21bdc0022621c12f15af08d0f2ddb1.39b9b709ac8605fc82116a2efc308181ba297c11950f0f350001e28f0e50868b

Liquidity pool onchainID | | adaOnly | integer

Example: adaOnly=1

Return only ADA pools or all pools (0, 1) | ### Responses **200** Liquidity pools successfully returned **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/token/pools TapTools OpenAPI https://openapi.taptools.io/api/v1/token/pools ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy Expand all Collapse all `[ * { * "exchange": "Minswap", * "lpTokenUnit": "e4214b7cce62ac6fbba385d164df48e157eae5863521b4b67ca71d8639b9b709ac8605fc82116a2efc308181ba297c11950f0f350001e28f0e50868b", * "onchainID": "0be55d262b29f564998ff81efe21bdc0022621c12f15af08d0f2ddb1.39b9b709ac8605fc82116a2efc308181ba297c11950f0f350001e28f0e50868b", * "tokenA": "8fef2d34078659493ce161a6c7fba4b56afefa8535296a5743f6958741414441", * "tokenALocked": 522963.34, * "tokenATicker": "LENFI", * "tokenB": "{empty for ADA}", * "tokenBLocked": 4393379.12, * "tokenBTicker": "ADA" } ]` [](https://openapi.taptools.io/#tag/Market-Tokens/paths/~1token~1prices/post) Token prices ------------------------------------------------------------------------------------------ Get an object with token units (policy + hex name) as keys and price as values for a list of policies and hex names. These prices are aggregated across all supported DEXs. Max batch size is `100` tokens. ##### Authorizations: _ApiAuthKey_ ##### Request Body schema: application/json required List of policy + hex names of tokens. Array string ### Responses **200** Prices successfully returned **400** Bad Request **401** Not Authorized **429** Rate Limit Exceeded **500** Interval Server Error post/token/prices TapTools OpenAPI https://openapi.taptools.io/api/v1/token/prices ### Request samples * Payload Content type application/json Copy `[ * "dda5fdb1002f7389b33e036b6afee82a8189becb6cba852e8b79b4fb0014df1047454e53" ]` ### Response samples * 200 * 400 * 401 * 429 * 500 Content type application/json Copy `{ * "dda5fdb1002f7389b33e036b6afee82a8189becb6cba852e8b79b4fb0014df1047454e53": 5 }` [](https://openapi.taptools.io/#tag/Market-Tokens/paths/~1token~1prices~1chg/get) Token price percent change ------------------------------------------------------------------------------------------------------------ Get a specific token's price percent change over various timeframes. Timeframe options include `[5m, 1h, 4h, 6h, 24h, 7d, 30d, 60d, 90d]`. All timeframes are returned by default. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | unit

required | string

Example: unit=8fef2d34078659493ce161a6c7fba4b56afefa8535296a5743f6958741414441

Token unit (policy + hex name) | | timeframes | string

Example: timeframes=1h,4h,24h,7d,30d

List of timeframes | ### Responses **200** Price changes returned **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/token/prices/chg TapTools OpenAPI https://openapi.taptools.io/api/v1/token/prices/chg ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy `{ * "1h": 0.007, * "4h": -0.061, * "5m": 0.024 }` [](https://openapi.taptools.io/#tag/Market-Tokens/paths/~1token~1quote/get) Quote price --------------------------------------------------------------------------------------- Get current quote price (e.g, current ADA/USD price). This only returns the price of ADA against the specified quote currency. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | quote | string

Example: quote=USD

Quote currency to use (USD, EUR, ETH, BTC). Default is `USD`. | ### Responses **200** Current Quote price successfully returned **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/token/quote TapTools OpenAPI https://openapi.taptools.io/api/v1/token/quote ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy `{ * "price": 0.61 }` [](https://openapi.taptools.io/#tag/Market-Tokens/paths/~1token~1quote~1available/get) Available quote currencies ----------------------------------------------------------------------------------------------------------------- Get all currently available quote currencies. ##### Authorizations: _ApiAuthKey_ ### Responses **200** Available quote currencies successfully returned **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/token/quote/available TapTools OpenAPI https://openapi.taptools.io/api/v1/token/quote/available ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy `[ * "USD" ]` [](https://openapi.taptools.io/#tag/Market-Tokens/paths/~1token~1top~1liquidity/get) Top liquidity tokens --------------------------------------------------------------------------------------------------------- Get tokens ranked by their DEX liquidity. This includes both AMM and order book liquidity. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | page | integer

Example: page=1

This endpoint supports pagination. Default page is `1`. | | perPage | integer

Example: perPage=10

Specify how many items to return per page. Maximum is `100`, default is `10`. | ### Responses **200** Top liquidity tokens successfully returned **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/token/top/liquidity TapTools OpenAPI https://openapi.taptools.io/api/v1/token/top/liquidity ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy Expand all Collapse all `[ * { * "liquidity": 504421.3324, * "price": 0.537, * "ticker": "AGIX", * "unit": "b46b12f0a61721a0358988f806a7c1562e1e622d5886a73194051f336d6131" } ]` [](https://openapi.taptools.io/#tag/Market-Tokens/paths/~1token~1top~1mcap/get) Top market cap tokens ----------------------------------------------------------------------------------------------------- Get tokens with top market cap in a descending order. This endpoint does exclude deprecated tokens (e.g. MELD V1 since there was a token migration to MELD V2). ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | type | string

Example: type=mcap

Sort tokens by circulating market cap or fully diluted value. Options `[mcap, fdv]`. | | page | integer

Example: page=1

This endpoint supports pagination. Default page is `1`. | | perPage | integer

Example: perPage=20

Specify how many items to return per page. Maximum is `100`, default is `20`. | ### Responses **200** Top market cap tokens successfully returned **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/token/top/mcap TapTools OpenAPI https://openapi.taptools.io/api/v1/token/top/mcap ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy Expand all Collapse all `[ * { * "circSupply": 1252742236.022414, * "fdv": 1074222392.55, * "mcap": 689889366.5, * "price": 0.537, * "ticker": "AGIX", * "totalSupply": 1374050373.74311, * "unit": "b46b12f0a61721a0358988f806a7c1562e1e622d5886a73194051f336d6131" } ]` [](https://openapi.taptools.io/#tag/Market-Tokens/paths/~1token~1top~1volume/get) Top volume tokens --------------------------------------------------------------------------------------------------- Get tokens with top volume for a given timeframe. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | timeframe | string

Example: timeframe=24h

Specify a timeframe in which to aggregate the data by. Options are `[1h, 4h, 12h, 24h, 7d, 30d, 180d, 1y, all]`. Default is `24h`. | | page | integer

Example: page=1

This endpoint supports pagination. Default page is `1`. | | perPage | integer

Example: perPage=20

Specify how many items to return per page. Maximum is `100`, default is `20`. | ### Responses **200** Top volume tokens successfully returned **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/token/top/volume TapTools OpenAPI https://openapi.taptools.io/api/v1/token/top/volume ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy Expand all Collapse all `[ * { * "price": 0.537, * "ticker": "AGIX", * "unit": "b46b12f0a61721a0358988f806a7c1562e1e622d5886a73194051f336d6131", * "volume": 103432.3324 } ]` [](https://openapi.taptools.io/#tag/Market-Tokens/paths/~1token~1trades/get) Token trades ----------------------------------------------------------------------------------------- Get token trades across the entire DEX market. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | timeframe | string

Example: timeframe=30d

The time interval. Options are `1h`, `4h`, `24h`, `7d`, `30d`, `90d`, `180d`, `1y`, `all`. Defaults to `30d`. | | sortBy | string

Example: sortBy=amount

What should the results be sorted by. Options are `amount`, `time`. Default is `amount`. Filters to only ADA trades if set to `amount`. | | order | string

Example: order=desc

Which direction should the results be sorted. Options are `asc`, `desc`. Default is `desc`. | | unit | string

Example: unit=279c909f348e533da5808898f87f9a14bb2c3dfbbacccd631d927a3f534e454b

Optionally filter to a specific token by specifying a token unit (policy + hex name). | | minAmount | integer

Example: minAmount=1000

Filter to only trades of a certain ADA amount. | | from | integer

Example: from=1704759422

Filter trades using a UNIX timestamp, will only return trades after this timestamp. | | page | integer

Example: page=1

This endpoint supports pagination. Default page is `1`. | | perPage | integer

Example: perPage=10

Specify how many items to return per page. Maximum is `100`, default is `10`. | ### Responses **200** Token trades successfully returned **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/token/trades TapTools OpenAPI https://openapi.taptools.io/api/v1/token/trades ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy Expand all Collapse all `[ * { * "action": "buy", * "address": "addr1q9j5jqhqak5nmqphdqt4cj9kq0gppa49afyznggw03hjzhwxr0exydkt78th5wwrjphxh0h6rrgghzwxse6q3pdf9sxqkg2mmq", * "exchange": "Minswap", * "hash": "8df1c6f66c0d02153f604ea588e792582908d3299ef6d322ae0448001791a24f", * "lpTokenUnit": "f5808c2c990d86da54bfc97d89cee6efa20cd8461616359478d96b4c35e27e3c7b4bef4824e5a4989a97e017fb8a1156d9823c20821e4d2f1fa168e4", * "price": 100, * "time": 1692781200, * "tokenA": "63bb8054f9142b46582198e280f489b3c928dfecb390b0cb39a5cbfe74657374746f6b656e32", * "tokenAAmount": 100, * "tokenAName": "TEST2", * "tokenB": "string", * "tokenBAmount": 200, * "tokenBName": "ADA" } ]` [](https://openapi.taptools.io/#tag/Market-Tokens/paths/~1token~1trading~1stats/get) Trading stats -------------------------------------------------------------------------------------------------- Get aggregated trading stats for a particular token. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | unit

required | string

Example: unit=8fef2d34078659493ce161a6c7fba4b56afefa8535296a5743f6958741414441

Token unit (policy + hex name) | | timeframe | string

Example: timeframe=24h

Specify a timeframe in which to aggregate the data by. Options are `[15m, 1h, 4h, 12h, 24h, 7d, 30d, 90d, 180d, 1y, all]`. Default is `24h`. | ### Responses **200** Trading stats successfully returned **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/token/trading/stats TapTools OpenAPI https://openapi.taptools.io/api/v1/token/trading/stats ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy `{ * "buyVolume": 234123.342, * "buyers": 134, * "buys": 189, * "sellVolume": 187432.654, * "sellers": 89, * "sells": 92 }` [](https://openapi.taptools.io/#tag/Onchain-Asset) Onchain » Asset ------------------------------------------------------------------ [](https://openapi.taptools.io/#tag/Onchain-Asset/paths/~1asset~1supply/get) Asset supply ----------------------------------------------------------------------------------------- Get onchain supply for a token. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | unit

required | string

Example: unit=8fef2d34078659493ce161a6c7fba4b56afefa8535296a5743f6958741414441

Token unit (policy + hex name) to filter by | ### Responses **200** Asset supply **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/asset/supply TapTools OpenAPI https://openapi.taptools.io/api/v1/asset/supply ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy `{ * "supply": 233838354 }` [](https://openapi.taptools.io/#tag/Onchain-Address) Onchain » Address ---------------------------------------------------------------------- [](https://openapi.taptools.io/#tag/Onchain-Address/paths/~1address~1info/get) Address info ------------------------------------------------------------------------------------------- Get address payment credential and stake address, along with its current aggregate lovelace and multi asset balance. Either `address` or `paymentCred` can be provided, but one must be provided. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | address | string

Example: address=addr1q9j5jqhqak5nmqphdqt4cj9kq0gppa49afyznggw03hjzhwxr0exydkt78th5wwrjphxh0h6rrgghzwxse6q3pdf9sxqkg2mmq

Address to query for | | paymentCred | string

Example: paymentCred=654902e0eda93d803768175c48b603d010f6a5ea4829a10e7c6f215d

Payment credential to query for | ### Responses **200** Address info **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/address/info TapTools OpenAPI https://openapi.taptools.io/api/v1/address/info ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy Expand all Collapse all `{ * "address": "addr1q9j5jqhqak5nmqphdqt4cj9kq0gppa49afyznggw03hjzhwxr0exydkt78th5wwrjphxh0h6rrgghzwxse6q3pdf9sxqkg2mmq", * "assets": [ * { * "unit": "dda5fdb1002f7389b33e036b6afee82a8189becb6cba852e8b79b4fb0014df1047454e53", * "value": "12000000" } ], * "lovelace": "45000000", * "paymentCred": "654902e0eda93d803768175c48b603d010f6a5ea4829a10e7c6f215d", * "stakeAddress": "stake1u8rphunzxm9lr4m688peqmnthmap35yt38rgvaqgsk5jcrqdr2vuc" }` [](https://openapi.taptools.io/#tag/Onchain-Address/paths/~1address~1utxos/get) Address UTxOs --------------------------------------------------------------------------------------------- Get current UTxOs at an address/payment credential. Either `address` or `paymentCred` can be provided, but one must be provided. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | address | string

Example: address=addr1q9j5jqhqak5nmqphdqt4cj9kq0gppa49afyznggw03hjzhwxr0exydkt78th5wwrjphxh0h6rrgghzwxse6q3pdf9sxqkg2mmq

Address to query for | | paymentCred | string

Example: paymentCred=654902e0eda93d803768175c48b603d010f6a5ea4829a10e7c6f215d

Payment credential to query for | | page | integer

Example: page=1

This endpoint supports pagination. Default page is `1`. | | perPage | integer

Example: perPage=100

Specify how many items to return per page. Maximum is `100`, default is `100`. | ### Responses **200** Address UTxOs **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/address/utxos TapTools OpenAPI https://openapi.taptools.io/api/v1/address/utxos ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy Expand all Collapse all `[ * { * "assets": [ * { * "quantity": "12000000", * "unit": "dda5fdb1002f7389b33e036b6afee82a8189becb6cba852e8b79b4fb0014df1047454e53" } ], * "hash": "a88d97638faf9fa63e4f4f8b4fd4664ae3505ae050bc48afde48f3c1e7b1e07b", * "index": 0, * "lovelace": "3703342" } ]` [](https://openapi.taptools.io/#tag/Onchain-Transaction) Onchain » Transaction ------------------------------------------------------------------------------ [](https://openapi.taptools.io/#tag/Onchain-Transaction/paths/~1transaction~1utxos/get) Transaction UTxOs --------------------------------------------------------------------------------------------------------- Get UTxOs from a specific transaction. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | hash | string

Example: hash=8be33680ec04da1cc98868699c5462fbbf6975529fb6371669fa735d2972d69b

Transaction hash | ### Responses **200** Transaction UTxOs **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/transaction/utxos TapTools OpenAPI https://openapi.taptools.io/api/v1/transaction/utxos ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy Expand all Collapse all `{ * "hash": "8be33680ec04da1cc98868699c5462fbbf6975529fb6371669fa735d2972d69b", * "inputs": [ * { * "assets": [ * { * "quantity": "12000000", * "unit": "dda5fdb1002f7389b33e036b6afee82a8189becb6cba852e8b79b4fb0014df1047454e53" } ], * "hash": "a88d97638faf9fa63e4f4f8b4fd4664ae3505ae050bc48afde48f3c1e7b1e07b", * "index": 0, * "lovelace": "3703342" } ], * "outputs": [ * { * "assets": [ * { * "quantity": "12000000", * "unit": "dda5fdb1002f7389b33e036b6afee82a8189becb6cba852e8b79b4fb0014df1047454e53" } ], * "hash": "a88d97638faf9fa63e4f4f8b4fd4664ae3505ae050bc48afde48f3c1e7b1e07b", * "index": 0, * "lovelace": "3703342" } ] }` [](https://openapi.taptools.io/#tag/Wallet-Portfolio) Wallet » Portfolio ------------------------------------------------------------------------ [](https://openapi.taptools.io/#tag/Wallet-Portfolio/paths/~1wallet~1portfolio~1positions/get) Portfolio positions ------------------------------------------------------------------------------------------------------------------ Get wallet's current portfolio positions with supporting market data. This includes positions that are staked in a smart contract and LP farm positions (for supported protocols) ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | address | string

Example: address=stake1u8rphunzxm9lr4m688peqmnthmap35yt38rgvaqgsk5jcrqdr2vuc

Address to query for | ### Responses **200** Portfolio positions successfully returned **400** Bad Request **401** Not Authorized **404** Not Found **429** Rate Limit Exceeded **500** Interval Server Error get/wallet/portfolio/positions TapTools OpenAPI https://openapi.taptools.io/api/v1/wallet/portfolio/positions ### Response samples * 200 * 400 * 401 * 404 * 429 * 500 Content type application/json Copy Expand all Collapse all `{ * "adaBalance": 10, * "adaValue": 10010, * "liquidValue": 10010, * "numFTs": 2, * "numNFTs": 1, * "positionsFt": [ * { * "24h": 0.11, * "30d": -0.32, * "7d": 0.03, * "adaValue": 10000, * "balance": 200, * "fingerprint": "fingerprint1", * "liquidBalance": 200, * "liquidValue": 10000, * "price": 100, * "ticker": "TEST1", * "unit": "b46b12f0a61721a0358988f806a7c1562e1e622d5886a73194051f336d6131" } ], * "positionsLp": [ * { * "adaValue": 400, * "amountLP": 100, * "exchange": "Minswap", * "ticker": "TEST2 / ADA LP", * "tokenA": "63bb8054f9142b46582198e280f489b3c928dfecb390b0cb39a5cbfe74657374746f6b656e32", * "tokenAAmount": 100, * "tokenAName": "TEST2", * "tokenB": "string", * "tokenBAmount": 200, * "tokenBName": "ADA", * "unit": "f22d56bc0daec9ff1e2d4d90061563517d279d3c998747d55234822874657374746f6b656e" } ], * "positionsNft": [ * { * "24h": 0.11, * "30d": -0.32, * "7d": 0.03, * "adaValue": 10000, * "balance": 2, * "floorPrice": 1, * "liquidValue": 10, * "listings": 3, * "name": "testCollection", * "policy": "4048d53202b57aec6eb8edd8e9e4196d8eeb9a5fe1dd50d6dfc67be3" } ] }` [](https://openapi.taptools.io/#tag/Wallet-Portfolio/paths/~1wallet~1trades~1tokens/get) Trade history (tokens) --------------------------------------------------------------------------------------------------------------- Get the token trade history for a particular wallet. Optionally pass a token unit to filter to a specific token. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | address

required | string

Example: address=stake1u8rphunzxm9lr4m688peqmnthmap35yt38rgvaqgsk5jcrqdr2vuc

Address to query for | | unit | string

Example: unit=8fef2d34078659493ce161a6c7fba4b56afefa8535296a5743f6958741414441

Token unit (policy + hex name) to filter by | | page | integer

Example: page=1

This endpoint supports pagination. Default page is `1`. | | perPage | integer

Example: perPage=100

Specify how many items to return per page. Maximum is `100`, default is `100`. | ### Responses **200** Wallet trade history successfully returned **400** Bad Request **401** Not Authorized **404** Not Found **406** Not acceptable **429** Rate Limit Exceeded **500** Interval Server Error get/wallet/trades/tokens TapTools OpenAPI https://openapi.taptools.io/api/v1/wallet/trades/tokens ### Response samples * 200 * 400 * 401 * 404 * 406 * 429 * 500 Content type application/json Copy Expand all Collapse all `[ * { * "action": "Buy", * "hash": "505cb5a55f7bbe0ed70e58d97b105220ea662fb91bbd89e915ca85f07500a9b9", * "time": 1692781200, * "tokenA": "63bb8054f9142b46582198e280f489b3c928dfecb390b0cb39a5cbfe74657374746f6b656e32", * "tokenAAmount": 10, * "tokenAName": "TEST1", * "tokenB": "string", * "tokenBAmount": 5, * "tokenBName": "ADA" } ]` [](https://openapi.taptools.io/#tag/Wallet-Portfolio/paths/~1wallet~1value~1trended/get) Portfolio trended value ---------------------------------------------------------------------------------------------------------------- Get historical trended value of an address in 4hr intervals. This includes the value of all tokens, NFTs, LP/farm positions, custodial staking, and assets involved in active loans (either being lent or used as collateral). **NOTE** this does not include staking rewards unless the rewards are withdrew from rewards account. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | address

required | string

Example: address=stake1u8rphunzxm9lr4m688peqmnthmap35yt38rgvaqgsk5jcrqdr2vuc

Address to query for | | timeframe | string

Example: timeframe=30d

The time interval. Options are `24h`, `7d`, `30d`, `90d`, `180d`, `1y`, `all`. Defaults to `30d`. | | quote | string

Example: quote=ADA

Quote currency to use (ADA, USD, EUR, ETH, BTC). Default is `ADA`. | ### Responses **200** Portfolio trended value successfully returned **400** Bad Request **401** Not Authorized **404** Not Found **406** Not acceptable **429** Rate Limit Exceeded **500** Interval Server Error get/wallet/value/trended TapTools OpenAPI https://openapi.taptools.io/api/v1/wallet/value/trended ### Response samples * 200 * 400 * 401 * 404 * 406 * 429 * 500 Content type application/json Copy Expand all Collapse all `[ * { * "time": 1692781200, * "value": 57 } ]` [](https://openapi.taptools.io/#tag/Integration) Integration ------------------------------------------------------------ [](https://openapi.taptools.io/#tag/Integration/paths/~1integration~1asset/get) Token by ID ------------------------------------------------------------------------------------------- Returns details of a given token by its address. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | id

required | string

Example: id=b46b12f0a61721a0358988f806a7c1562e1e622d5886a73194051f336d6131

Token ID | ### Responses **200** Token info **400** Bad Request **401** Not Authorized **429** Rate Limit Exceeded **500** Interval Server Error get/integration/asset TapTools OpenAPI https://openapi.taptools.io/api/v1/integration/asset ### Response samples * 200 * 400 * 401 * 429 * 500 Content type application/json Copy Expand all Collapse all `{ * "asset": { * "circulatingSupply": 1500000, * "id": "b46b12f0a61721a0358988f806a7c1562e1e622d5886a73194051f336d6131", * "name": "snek coin", * "symbol": "SNEK", * "totalSupply": 2000000 } }` [](https://openapi.taptools.io/#tag/Integration/paths/~1integration~1block/get) Block ------------------------------------------------------------------------------------- Returns a specific block using either the number of the block or its timestamp. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | number | integer

Example: number=10937538

Block number | | timestamp | integer

Example: timestamp=1728408176

Block timestamp | ### Responses **200** Block info **400** Bad Request **401** Not Authorized **429** Rate Limit Exceeded **500** Interval Server Error get/integration/block TapTools OpenAPI https://openapi.taptools.io/api/v1/integration/block ### Response samples * 200 * 400 * 401 * 429 * 500 Content type application/json Copy Expand all Collapse all `{ * "block": { * "blockNumber": 10937538, * "blockTimestamp": 1728408176 } }` [](https://openapi.taptools.io/#tag/Integration/paths/~1integration~1events/get) Events --------------------------------------------------------------------------------------- List of events occured in a range of blocks. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | fromBlock

required | integer

Example: fromBlock=10937538

Block number to start filtering at (inclusive). | | toBlock

required | integer

Example: toBlock=10937542

Block number to end filtering at (inclusive). | | limit | integer

Example: limit=1000

Limit results to a maximum count, Defaults to `1000`, With a maximum of `1000`. | ### Responses **200** Events info **400** Bad Request **401** Not Authorized **429** Rate Limit Exceeded **500** Interval Server Error get/integration/events TapTools OpenAPI https://openapi.taptools.io/api/v1/integration/events ### Response samples * 200 * 400 * 401 * 429 * 500 Content type application/json Copy Expand all Collapse all `{ * "events": [ * { * "amount0": "string", * "amount1": "string", * "asset0In": "0", * "asset0Out": "200", * "asset1In": "10", * "asset1Out": "0", * "block": { * "blockNumber": 10937538, * "blockTimestamp": 1728408176 }, * "eventIndex": 10937538000000, * "eventType": "swap", * "maker": "addr1q8ete2wpeulwq5yxutftpqdmgu2rntld85x7ztswahs2t0daytnqe6ea4p09jpv8mz3umpsdk9gkqvkhca7nngxrp2lqnh0x4l", * "pairId": "nikeswaporderbook.44759dc63605dbf88700b241ee451aa5b0334cf2b34094d836fbdf8642757a7a696542656520.ada", * "reserves": { * "asset0": "20000000", * "asset1": "10000" }, * "txnId": "a88d97638faf9fa63e4f4f8b4fd4664ae3505ae050bc48afde48f3c1e7b1e07b", * "txnIndex": 115981434 } ] }` [](https://openapi.taptools.io/#tag/Integration/paths/~1integration~1exchange/get) DEX -------------------------------------------------------------------------------------- Return details of a given DEX by its factory address or alternative id. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | id

required | string

Example: id=7

Exchange id | ### Responses **200** Exchange info **400** Bad Request **401** Not Authorized **429** Rate Limit Exceeded **500** Interval Server Error get/integration/exchange TapTools OpenAPI https://openapi.taptools.io/api/v1/integration/exchange ### Response samples * 200 * 400 * 401 * 429 * 500 Content type application/json Copy Expand all Collapse all `{ * "exchange": { * "factoryAddress": "3", * "logoURL": "[https://www.logos.com/minswap.png](https://www.logos.com/minswap.png) ", * "name": "Minswap" } }` [](https://openapi.taptools.io/#tag/Integration/paths/~1integration~1latest-block/get) Latest block --------------------------------------------------------------------------------------------------- Returns the latest block processed in the blockchain/DEX. ##### Authorizations: _ApiAuthKey_ ### Responses **200** Block info **400** Bad Request **401** Not Authorized **429** Rate Limit Exceeded **500** Interval Server Error get/integration/latest-block TapTools OpenAPI https://openapi.taptools.io/api/v1/integration/latest-block ### Response samples * 200 * 400 * 401 * 429 * 500 Content type application/json Copy Expand all Collapse all `{ * "block": { * "blockNumber": 10937538, * "blockTimestamp": 1728408176 } }` [](https://openapi.taptools.io/#tag/Integration/paths/~1integration~1pair/get) Pair by ID ----------------------------------------------------------------------------------------- Returns pair details (aka pool) by its address. ##### Authorizations: _ApiAuthKey_ ##### query Parameters | | | | --- | --- | | id

required | string

Example: id=nikeswaporderbook.44759dc63605dbf88700b241ee451aa5b0334cf2b34094d836fbdf8642757a7a696542656520.ada

Pair ID | ### Responses **200** Pair info **400** Bad Request **401** Not Authorized **429** Rate Limit Exceeded **500** Interval Server Error get/integration/pair TapTools OpenAPI https://openapi.taptools.io/api/v1/integration/pair ### Response samples * 200 * 400 * 401 * 429 * 500 Content type application/json Copy Expand all Collapse all `{ * "pair": { * "asset0Id": "279c909f348e533da5808898f87f9a14bb2c3dfbbacccd631d927a3f534e454b", * "asset1Id": "000000000000000000000000000000000000000000000000000000006c6f76656c616365", * "createdAtBlockNumber": 10937538, * "createdAtBlockTimestamp": 1728408176, * "createdAtTxnId": 115981434, * "factoryAddress": "4", * "id": "nikeswaporderbook.44759dc63605dbf88700b241ee451aa5b0334cf2b34094d836fbdf8642757a7a696542656520.ada" } }` ---