Get a single strategy overview

Returns full state and metadata for one maker strategy identified by chain, maker, application, and strategy hash.

GEThttps://api.1inch.com/aqua/v1.0/strategies/overview/{chainId}/{maker}/{app}/{strategyHash}
Supported on:
EthereumBaseBNB ChainArbitrumAvalancheZKsyncGnosisOptimismPolygonLineaSonicUnichainRobinhood Chain

Parameters

chainId
* number (Enum)path
EVM chain id
maker
* string path
Strategy creator address
app
* string path
App contract address
strategyHash
* string path
32-byte strategy hash (0x + 64 hex)

Request Body

This request doesn’t have any request body.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
const axios = require('axios');

async function httpCall() {
  const url =
    'https://api.1inch.com/aqua/v1.0/strategies/overview/{chainId}/{maker}/{app}/{strategyHash}';

  const config = {
    headers: {
      Authorization: `Bearer ${API_KEY}`,
    },
    params: {},
    paramsSerializer: {
      indexes: null,
    },
  };

  try {
    const response = await axios.get(url, config);
    console.log(response.data);
  } catch (error) {
    console.error(error);
  }
}

Returns

StrategyOverviewResponseDto object
Detailed overview of a single strategy: tokens, status, performance, and prices
strategyBytes
* string
ABI-encoded strategy configuration bytes, null when omitted (see strategyBytesOmittedReason)
strategyBytesOmittedReason
* string (Enum)
Reason strategyBytes was omitted (null), or null when served. SIZE_EXCEEDS_LIMIT means the stored bytes exceed this service's configured serving limit (currently 40960 bytes); strategyBytesSize always reports the real stored size regardless. To get the full bytes for an omitted strategy, fetch them from the on-chain Shipped event for this strategyHash.
SIZE_EXCEEDS_LIMIT
strategyBytesSize
* number
Raw stored strategy bytes length, in bytes (not hex-string length)
tokens
* array
Tokens tracked by this strategy, sorted by hex address ascending
items
StrategyOverviewTokenDto object
Token tracked by the strategy with balances, wallet data, and returned amount
address
* string
ERC-20 token contract address (checksummed hex)
meta
* object
Token metadata; null when the token cannot be parsed
allOf[0]
TokenMetaDto object
ERC-20 token metadata (decimals, symbol, name, logo)
decimals
* number
Token decimal places
symbol
* string
Token ticker symbol
name
* string
Full token name
logoURI
string
URL of the token logo image
initialBalance
* any
Token balance at the time the strategy was opened (shipped)
allOf[0]
TokenInitialBalanceDto object
Token balance allocated to the strategy at creation time with its USD value
raw
* string
Raw token amount allocated to the strategy at the time of its creation (integer string, no decimals)
usd
* number
USD value of the initial balance at strategy ship time; null when price data is unavailable
currentBalance
* any
Current token balance held by the strategy contract
allOf[0]
TokenCurrentBalanceDto object
Current token balance of the strategy contract with its USD value
raw
* string
Raw token amount currently allocated to the strategy (integer string, no decimals)
usd
* number
Current USD value of the balance; null when price data is unavailable
wallet
* any
Maker wallet balance and allowance for this token
allOf[0]
WalletDto object
Maker wallet balance and allowance for a token
balance
* any
Maker wallet balance for the token
allOf[0]
WalletBalanceDto object
Maker wallet token balance with its USD value
raw
* string
Raw wallet token balance (integer string, no decimals); null when not yet indexed
usd
* number
USD value of the wallet balance; null when price data is unavailable or balance not indexed
allowance
* string
Maker wallet allowance for the application (integer string); null when not yet indexed
decimals
* number
Token decimals; null when token metadata is unavailable
returnedAmount
* object
Amount returned to the maker when the strategy was closed; null when not closed or data unavailable
allOf[0]
TokenReturnedAmountDto object
Amount returned to the maker on strategy close, raw and in USD
raw
* string
Raw returned amount as decimal string (no decimals applied)
usd
* number
Returned amount in USD; null when token price is unavailable
status
* string (Enum)
High-level status derived from closedAt: "open" if null, else "closed"
open
closed
performance
* any
Performance metrics
allOf[0]
PerformanceDto object
Strategy performance metrics: fees and incoming volume
fees
* any
Fee performance breakdown
allOf[0]
PerformanceFeesDto object
Fee performance broken down by time window (total, 24h, 7d, 30d, 90d, 180d)
total
* any
All-time fee metrics
allOf[0]
PerformanceFeesPeriodDto object
Fee metrics (USD and APY) for a single time window
usd
* number
Fees collected in USD for the period. null when no usd price for all tokens in the strategy
apy
* number
Annualised fee yield (APY) denominated in Percent for the period. Measured against the wallet-backed capital: the initial balance capped by what the maker held and approved when the position opened, so declared reserves the wallet never covered do not dilute it. null when the fees or that capital are unpriced, when the measured time is under an hour, or when the annualised result carries no information
last24h
* any
Fee metrics for the last 24 hours
allOf[0]
PerformanceFeesPeriodDto object
Fee metrics (USD and APY) for a single time window
usd
* number
Fees collected in USD for the period. null when no usd price for all tokens in the strategy
apy
* number
Annualised fee yield (APY) denominated in Percent for the period. Measured against the wallet-backed capital: the initial balance capped by what the maker held and approved when the position opened, so declared reserves the wallet never covered do not dilute it. null when the fees or that capital are unpriced, when the measured time is under an hour, or when the annualised result carries no information
last7d
* any
Fee metrics for the last 7 days
allOf[0]
PerformanceFeesPeriodDto object
Fee metrics (USD and APY) for a single time window
usd
* number
Fees collected in USD for the period. null when no usd price for all tokens in the strategy
apy
* number
Annualised fee yield (APY) denominated in Percent for the period. Measured against the wallet-backed capital: the initial balance capped by what the maker held and approved when the position opened, so declared reserves the wallet never covered do not dilute it. null when the fees or that capital are unpriced, when the measured time is under an hour, or when the annualised result carries no information
last30d
* any
Fee metrics for the last 30 days
allOf[0]
PerformanceFeesPeriodDto object
Fee metrics (USD and APY) for a single time window
usd
* number
Fees collected in USD for the period. null when no usd price for all tokens in the strategy
apy
* number
Annualised fee yield (APY) denominated in Percent for the period. Measured against the wallet-backed capital: the initial balance capped by what the maker held and approved when the position opened, so declared reserves the wallet never covered do not dilute it. null when the fees or that capital are unpriced, when the measured time is under an hour, or when the annualised result carries no information
last90d
* any
Fee metrics for the last 90 days
allOf[0]
PerformanceFeesPeriodDto object
Fee metrics (USD and APY) for a single time window
usd
* number
Fees collected in USD for the period. null when no usd price for all tokens in the strategy
apy
* number
Annualised fee yield (APY) denominated in Percent for the period. Measured against the wallet-backed capital: the initial balance capped by what the maker held and approved when the position opened, so declared reserves the wallet never covered do not dilute it. null when the fees or that capital are unpriced, when the measured time is under an hour, or when the annualised result carries no information
last180d
* any
Fee metrics for the last 180 days
allOf[0]
PerformanceFeesPeriodDto object
Fee metrics (USD and APY) for a single time window
usd
* number
Fees collected in USD for the period. null when no usd price for all tokens in the strategy
apy
* number
Annualised fee yield (APY) denominated in Percent for the period. Measured against the wallet-backed capital: the initial balance capped by what the maker held and approved when the position opened, so declared reserves the wallet never covered do not dilute it. null when the fees or that capital are unpriced, when the measured time is under an hour, or when the annualised result carries no information
volume
* any
Incoming volume breakdown in USD
allOf[0]
PerformanceVolumeDto object
Incoming volume broken down by time window (total, 24h, 7d, 30d, 90d, 180d)
total
* any
All-time total incoming volume
allOf[0]
PerformanceVolumePeriodDto object
Incoming volume in USD for a single time window
usd
* number
Incoming volume in USD for the period. null when no USD price is indexed for any token; otherwise the sum over priced tokens.
last24h
* any
Incoming volume for the last 24 hours
allOf[0]
PerformanceVolumePeriodDto object
Incoming volume in USD for a single time window
usd
* number
Incoming volume in USD for the period. null when no USD price is indexed for any token; otherwise the sum over priced tokens.
last7d
* any
Incoming volume for the last 7 days
allOf[0]
PerformanceVolumePeriodDto object
Incoming volume in USD for a single time window
usd
* number
Incoming volume in USD for the period. null when no USD price is indexed for any token; otherwise the sum over priced tokens.
last30d
* any
Incoming volume for the last 30 days
allOf[0]
PerformanceVolumePeriodDto object
Incoming volume in USD for a single time window
usd
* number
Incoming volume in USD for the period. null when no USD price is indexed for any token; otherwise the sum over priced tokens.
last90d
* any
Incoming volume for the last 90 days
allOf[0]
PerformanceVolumePeriodDto object
Incoming volume in USD for a single time window
usd
* number
Incoming volume in USD for the period. null when no USD price is indexed for any token; otherwise the sum over priced tokens.
last180d
* any
Incoming volume for the last 180 days
allOf[0]
PerformanceVolumePeriodDto object
Incoming volume in USD for a single time window
usd
* number
Incoming volume in USD for the period. null when no USD price is indexed for any token; otherwise the sum over priced tokens.
classification
* any
Strategy type and lifecycle classification
allOf[0]
StrategyOverviewClassificationDto object
Strategy type and lifecycle state classification
type
* string (Enum)
AMM strategy formula type
concentrated
pegged
xyc
unknown
state
* string (Enum)
Lifecycle state of the strategy. "active" — open and position is healthy; "illiquidity" — open but maker has insufficient real balance/allowance for the current virtual balance of at least one token; "closed" — strategy was docked
active
illiquidity
closed
feePercent
* number
Maker`s flat fee on a strategy. null when the strategy is unknown
openedAt
* number
Unix timestamp (seconds) when the strategy was opened (Shipped event)
closedAt
* number
Unix timestamp (seconds) when the strategy was closed (Docked event); null if still open
priceRange
* object
Human-readable concentrated price range (quote per base). Null for non-concentrated strategies or when either token decimals are unavailable
allOf[0]
PriceRangeDto object
Concentrated strategy price range bounds (quote per base) with USD values
min
* string
Human-readable lower bound of the concentrated price range (quote per base)
max
* string
Human-readable upper bound of the concentrated price range (quote per base)
minUsd
* number
USD value of the lower price bound
maxUsd
* number
USD value of the upper price bound
quoteSymbol
* string
Symbol of the quote token
openingPrice
* object
Human-readable opening price at strategy inception (quote per base). Null for non-concentrated strategies or when either token decimals are unavailable
allOf[0]
OpeningPriceDto object
Opening price at strategy inception (quote per base) with USD value
value
* string
Human-readable opening price at strategy inception (quote per base)
usd
* number
USD value of the opening price
quoteSymbol
* string
Symbol of the quote token
JSON
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
{
  "strategyBytes": "0x0000000000000000000000001234...",
  "strategyBytesOmittedReason": "SIZE_EXCEEDS_LIMIT",
  "strategyBytesSize": 128,
  "tokens": [
    {
      "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "meta": {
        "decimals": 18,
        "symbol": "USDC",
        "name": "USD Coin",
        "logoURI": "https://tokens.1inch.io/0xa0b86991.png"
      },
      "initialBalance": {
        "raw": "1000000000000000000",
        "usd": 1234.56
      },
      "currentBalance": {
        "raw": "500000000000000000",
        "usd": 617.28
      },
      "wallet": {
        "balance": {
          "raw": "500000000000000000",
          "usd": 617.28
        },
        "allowance": "500000000000000000"
      },
      "decimals": 18,
      "returnedAmount": {
        "raw": "1000000000000000000",
        "usd": 1234.56
      }
    }
  ],
  "status": "open",
  "performance": {
    "fees": {
      "total": {
        "usd": 12.23,
        "apy": 10.25
      },
      "last24h": {
        "usd": 12.23,
        "apy": 10.25
      },
      "last7d": {
        "usd": 12.23,
        "apy": 10.25
      },
      "last30d": {
        "usd": 12.23,
        "apy": 10.25
      },
      "last90d": {
        "usd": 12.23,
        "apy": 10.25
      },
      "last180d": {
        "usd": 12.23,
        "apy": 10.25
      }
    },
    "volume": {
      "total": {
        "usd": 25271
      },
      "last24h": {
        "usd": 25271
      },
      "last7d": {
        "usd": 25271
      },
      "last30d": {
        "usd": 25271
      },
      "last90d": {
        "usd": 25271
      },
      "last180d": {
        "usd": 25271
      }
    }
  },
  "classification": {
    "type": "concentrated",
    "state": "active",
    "feePercent": 0.05
  },
  "openedAt": 1705312800,
  "closedAt": null,
  "priceRange": {
    "min": "1234.56",
    "max": "5678.90",
    "minUsd": 1800,
    "maxUsd": 1900,
    "quoteSymbol": "USDC"
  },
  "openingPrice": {
    "value": "2345.67",
    "usd": 1893,
    "quoteSymbol": "USDC"
  }
}

Did you find what you need?