> For the complete documentation index, see [llms.txt](https://docs.syntetika.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.syntetika.io/for-integrators/api-reference.md).

# API Reference

Every route, parameter and response field of the Syntetika Public API, generated from the OpenAPI specification. Base URL `https://public.api.syntetika.io`, no authentication.&#x20;

<table><thead><tr><th width="193.96875">Syntetika Public API</th><th>Conventions</th></tr></thead><tbody><tr><td>Auth</td><td>None. CORS allows every origin. Every route is <code>GET</code> except <code>POST /rpc/{chain}</code>.</td></tr><tr><td>Rate limit</td><td>10 requests per 10 seconds per IP, for every caller. Over the limit returns <code>429</code> with an HTML body; wait about 10 seconds. Cache responses on your side.</td></tr><tr><td>Format</td><td>JSON (PDF for statements and factsheets). Addresses are <code>0x</code> plus 40 hex characters, vault ids are UUIDs, timestamps are unix milliseconds unless marked seconds, dates are <code>YYYY-MM-DD</code>. <code>%</code> fields are percentage points; fields marked decimal are fractions.</td></tr><tr><td>Vault IDs</td><td>hBTC <code>75142b34-9345-48b3-80e5-765b81e75302</code> (Base)<br>oneUSD <code>e7f39a87-e5bb-4a11-b6a4-8a1ec710939f</code> (Ethereum)</td></tr></tbody></table>

A PDF copy of this reference is available for offline use.

{% file src="/files/a99nA4BZ06hG5OVT0dMI" %}

## Protocol headline numbers

> Total TVL, active vault count, cumulative yield paid and average net APY.

```json
{"openapi":"3.0.3","info":{"title":"Syntetika Public API","version":"1.0.0"},"tags":[{"name":"General","description":"Protocol-wide numbers and the vault list."}],"servers":[{"url":"https://public.api.syntetika.io"}],"paths":{"/general/stats":{"get":{"tags":["General"],"summary":"Protocol headline numbers","description":"Total TVL, active vault count, cumulative yield paid and average net APY.","operationId":"getGeneralStats","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"totalTvl":{"$ref":"#/components/schemas/Numeric"},"activeVaultsCount":{"$ref":"#/components/schemas/Numeric"},"cumulativeYieldPaid":{"allOf":[{"$ref":"#/components/schemas/Numeric"}],"description":"USD"},"avgNetApy":{"$ref":"#/components/schemas/Numeric"}}}}}}}}}},"components":{"schemas":{"Numeric":{"description":"Passed straight through from a NUMERIC database column; arrives as a number or a decimal string.","oneOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]}}}}
```

## List vaults

> Every vault with its TVL, receipt-token price, net APY and managers. This is the summary behind the vault list. Each vault's id is \`loanId\`. Use \`/vault/{vault}\` for full detail.

```json
{"openapi":"3.0.3","info":{"title":"Syntetika Public API","version":"1.0.0"},"tags":[{"name":"General","description":"Protocol-wide numbers and the vault list."}],"servers":[{"url":"https://public.api.syntetika.io"}],"paths":{"/general/vaults":{"get":{"tags":["General"],"summary":"List vaults","description":"Every vault with its TVL, receipt-token price, net APY and managers. This is the summary behind the vault list. Each vault's id is `loanId`. Use `/vault/{vault}` for full detail.","operationId":"listVaults","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"vaults":{"type":"array","items":{"$ref":"#/components/schemas/VaultSummary"}}}}}}}}}}},"components":{"schemas":{"VaultSummary":{"type":"object","properties":{"loanId":{"type":"string","description":"Vault id"},"name":{"type":"string","nullable":true},"chain":{"type":"string","nullable":true},"depositAsset":{"type":"string","nullable":true,"description":"Symbol"},"curator":{"type":"string"},"receiptToken":{"type":"string","nullable":true,"description":"Share token symbol"},"tvl":{"type":"object","properties":{"tokens":{"allOf":[{"$ref":"#/components/schemas/Numeric"}],"description":"Deposit asset"},"usd":{"$ref":"#/components/schemas/Numeric"}}},"tokenPrice":{"type":"number","nullable":true,"description":"Receipt-token price in deposit asset"},"netApy":{"type":"number","nullable":true,"description":"%, after performance fee, incl. Merkl rewards"},"managers":{"type":"array","description":"Curator first, then alphabetical","items":{"$ref":"#/components/schemas/Manager"}},"asset_manager":{"type":"string"},"vault_manager":{"type":"string"}}},"Numeric":{"description":"Passed straight through from a NUMERIC database column; arrives as a number or a decimal string.","oneOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]},"Manager":{"type":"object","properties":{"name":{"type":"string","nullable":true},"logoUrl":{"type":"string","nullable":true},"websiteUrl":{"type":"string","nullable":true}}}}}}
```

## External DeFi opportunities

> Yield opportunities in external DeFi pools (Morpho, Aave, Curve, Pendle and others), synced from DefiLlama, sorted by APY highest first.

```json
{"openapi":"3.0.3","info":{"title":"Syntetika Public API","version":"1.0.0"},"tags":[{"name":"General","description":"Protocol-wide numbers and the vault list."}],"servers":[{"url":"https://public.api.syntetika.io"}],"paths":{"/general/opportunities":{"get":{"tags":["General"],"summary":"External DeFi opportunities","description":"Yield opportunities in external DeFi pools (Morpho, Aave, Curve, Pendle and others), synced from DefiLlama, sorted by APY highest first.","operationId":"listOpportunities","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"opportunities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"protocol":{"type":"string"},"poolAddress":{"type":"string"},"chain":{"type":"string"},"apy":{"type":"number","nullable":true,"description":"Decimal, base yield"},"apyReward":{"type":"number","nullable":true,"description":"Decimal, reward incentives"},"tvl":{"type":"number","nullable":true,"description":"USD"},"lastSynced":{"type":"string","format":"date-time"}}}}}}}}}}}}}}
```

## Vault detail

> Full detail for one vault; metadata, fees, TVL and capacity, APY, drawdown, and the next NAV strike, attestation window and settlement dates.

```json
{"openapi":"3.0.3","info":{"title":"Syntetika Public API","version":"1.0.0"},"tags":[{"name":"Vault","description":"Full detail for one vault."}],"servers":[{"url":"https://public.api.syntetika.io"}],"paths":{"/vault/{vault}":{"get":{"tags":["Vault"],"summary":"Vault detail","description":"Full detail for one vault; metadata, fees, TVL and capacity, APY, drawdown, and the next NAV strike, attestation window and settlement dates.","operationId":"getVault","parameters":[{"$ref":"#/components/parameters/VaultPath"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VaultDetail"}}}},"404":{"$ref":"#/components/responses/NotFound"}}}}},"components":{"parameters":{"VaultPath":{"name":"vault","in":"path","required":true,"description":"Vault id (UUID). `400` if malformed.","schema":{"$ref":"#/components/schemas/VaultId"}}},"schemas":{"VaultId":{"type":"string","format":"uuid"},"VaultDetail":{"type":"object","properties":{"name":{"type":"string","nullable":true},"display_name":{"type":"string","nullable":true},"address":{"type":"string","nullable":true,"description":"Vault contract"},"chain":{"type":"string","nullable":true},"company_name":{"type":"string","nullable":true},"asset_manager":{"type":"string","nullable":true},"vault_manager":{"type":"string","nullable":true},"managers":{"type":"array","items":{"$ref":"#/components/schemas/Manager"}},"performance_fee":{"allOf":[{"$ref":"#/components/schemas/Numeric"}],"description":"%"},"fund_management_fee":{"type":"number","description":"%"},"fund_performance_fee":{"type":"number","description":"%"},"share_symbol":{"type":"string","nullable":true},"share_address":{"type":"string","nullable":true},"asset_symbol":{"type":"string","nullable":true},"asset_address":{"type":"string","nullable":true},"vault_symbol":{"type":"string","nullable":true},"strategy":{"description":"As stored"},"verification_level":{"description":"As stored"},"implementation_details":{"description":"As stored"},"tags":{"description":"As stored"},"net_apy":{"type":"number","nullable":true,"description":"%, after performance fee, incl. Merkl rewards"},"rewards_apy":{"type":"number","description":"%, Merkl rewards portion"},"current_apr":{"allOf":[{"$ref":"#/components/schemas/Numeric"}],"description":"30-day APY"},"tvl":{"allOf":[{"$ref":"#/components/schemas/Numeric"}],"description":"Deposit asset"},"tvl_usd":{"$ref":"#/components/schemas/Numeric"},"total_assets":{"allOf":[{"$ref":"#/components/schemas/Numeric"}],"description":"Same as tvl"},"total_supply":{"$ref":"#/components/schemas/Numeric"},"capacity":{"$ref":"#/components/schemas/Numeric"},"capacity_remaining":{"$ref":"#/components/schemas/Numeric"},"capacity_remaining_percentage":{"type":"number"},"share_price":{"type":"string","description":"Receipt-token price in deposit asset"},"exchange_rate":{"allOf":[{"$ref":"#/components/schemas/Numeric"}],"description":"Shares per deposit asset (1 / share_price)"},"max_drawdown":{"type":"number","nullable":true,"description":"Negative decimal (-0.003 = -0.30%); null without NAVC data"},"next_nav_strike":{"type":"integer","nullable":true,"description":"Unix ms; null for vaults NAVC does not report on"},"next_nav_attestation":{"type":"integer","nullable":true,"description":"Earliest expected attestation, unix ms"},"next_nav_attestation_max":{"type":"integer","nullable":true,"description":"Latest expected attestation, unix ms"},"deposit_settlement_date":{"type":"string","format":"date-time"},"deposit_settlement_timestamp":{"type":"integer"},"withdraw_settlement_date":{"type":"string","format":"date-time"},"withdraw_settlement_timestamp":{"type":"integer"}}},"Manager":{"type":"object","properties":{"name":{"type":"string","nullable":true},"logoUrl":{"type":"string","nullable":true},"websiteUrl":{"type":"string","nullable":true}}},"Numeric":{"description":"Passed straight through from a NUMERIC database column; arrives as a number or a decimal string.","oneOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}},"additionalProperties":true}},"responses":{"NotFound":{"description":"Not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}
```

## Vault detail (user address accepted, ignored)

> Same as \`/vault/{vault}\`. \`userAddress\` is accepted but currently ignored.

```json
{"openapi":"3.0.3","info":{"title":"Syntetika Public API","version":"1.0.0"},"tags":[{"name":"Vault","description":"Full detail for one vault."}],"servers":[{"url":"https://public.api.syntetika.io"}],"paths":{"/vault/{vault}/{userAddress}":{"get":{"tags":["Vault"],"summary":"Vault detail (user address accepted, ignored)","description":"Same as `/vault/{vault}`. `userAddress` is accepted but currently ignored.","operationId":"getVaultForUser","parameters":[{"$ref":"#/components/parameters/VaultPath"},{"name":"userAddress","in":"path","required":true,"description":"Ignored.","schema":{"$ref":"#/components/schemas/Address"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VaultDetail"}}}},"404":{"$ref":"#/components/responses/NotFound"}}}}},"components":{"parameters":{"VaultPath":{"name":"vault","in":"path","required":true,"description":"Vault id (UUID). `400` if malformed.","schema":{"$ref":"#/components/schemas/VaultId"}}},"schemas":{"VaultId":{"type":"string","format":"uuid"},"Address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"VaultDetail":{"type":"object","properties":{"name":{"type":"string","nullable":true},"display_name":{"type":"string","nullable":true},"address":{"type":"string","nullable":true,"description":"Vault contract"},"chain":{"type":"string","nullable":true},"company_name":{"type":"string","nullable":true},"asset_manager":{"type":"string","nullable":true},"vault_manager":{"type":"string","nullable":true},"managers":{"type":"array","items":{"$ref":"#/components/schemas/Manager"}},"performance_fee":{"allOf":[{"$ref":"#/components/schemas/Numeric"}],"description":"%"},"fund_management_fee":{"type":"number","description":"%"},"fund_performance_fee":{"type":"number","description":"%"},"share_symbol":{"type":"string","nullable":true},"share_address":{"type":"string","nullable":true},"asset_symbol":{"type":"string","nullable":true},"asset_address":{"type":"string","nullable":true},"vault_symbol":{"type":"string","nullable":true},"strategy":{"description":"As stored"},"verification_level":{"description":"As stored"},"implementation_details":{"description":"As stored"},"tags":{"description":"As stored"},"net_apy":{"type":"number","nullable":true,"description":"%, after performance fee, incl. Merkl rewards"},"rewards_apy":{"type":"number","description":"%, Merkl rewards portion"},"current_apr":{"allOf":[{"$ref":"#/components/schemas/Numeric"}],"description":"30-day APY"},"tvl":{"allOf":[{"$ref":"#/components/schemas/Numeric"}],"description":"Deposit asset"},"tvl_usd":{"$ref":"#/components/schemas/Numeric"},"total_assets":{"allOf":[{"$ref":"#/components/schemas/Numeric"}],"description":"Same as tvl"},"total_supply":{"$ref":"#/components/schemas/Numeric"},"capacity":{"$ref":"#/components/schemas/Numeric"},"capacity_remaining":{"$ref":"#/components/schemas/Numeric"},"capacity_remaining_percentage":{"type":"number"},"share_price":{"type":"string","description":"Receipt-token price in deposit asset"},"exchange_rate":{"allOf":[{"$ref":"#/components/schemas/Numeric"}],"description":"Shares per deposit asset (1 / share_price)"},"max_drawdown":{"type":"number","nullable":true,"description":"Negative decimal (-0.003 = -0.30%); null without NAVC data"},"next_nav_strike":{"type":"integer","nullable":true,"description":"Unix ms; null for vaults NAVC does not report on"},"next_nav_attestation":{"type":"integer","nullable":true,"description":"Earliest expected attestation, unix ms"},"next_nav_attestation_max":{"type":"integer","nullable":true,"description":"Latest expected attestation, unix ms"},"deposit_settlement_date":{"type":"string","format":"date-time"},"deposit_settlement_timestamp":{"type":"integer"},"withdraw_settlement_date":{"type":"string","format":"date-time"},"withdraw_settlement_timestamp":{"type":"integer"}}},"Manager":{"type":"object","properties":{"name":{"type":"string","nullable":true},"logoUrl":{"type":"string","nullable":true},"websiteUrl":{"type":"string","nullable":true}}},"Numeric":{"description":"Passed straight through from a NUMERIC database column; arrives as a number or a decimal string.","oneOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}},"additionalProperties":true}},"responses":{"NotFound":{"description":"Not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}
```

## Vault time series

> Share price, TVL, APY and NAVC-reported returns for charts. Every array lines up index-for-index with \`dates\`, except the two \`\*OOS\` series, which line up with \`navcNetRorsOOSDates\`. An unknown vault returns empty arrays rather than \`404\`.\
> \
> The \`navc\*\` arrays are empty for vaults NAVC does not report on. The \`\*OOS\` (out-of-sample, pre-vault track record) arrays are populated for hBTC only.<br>

```json
{"openapi":"3.0.3","info":{"title":"Syntetika Public API","version":"1.0.0"},"tags":[{"name":"Performance","description":"Time series for charts."}],"servers":[{"url":"https://public.api.syntetika.io"}],"paths":{"/performance/{vault}":{"get":{"tags":["Performance"],"summary":"Vault time series","description":"Share price, TVL, APY and NAVC-reported returns for charts. Every array lines up index-for-index with `dates`, except the two `*OOS` series, which line up with `navcNetRorsOOSDates`. An unknown vault returns empty arrays rather than `404`.\n\nThe `navc*` arrays are empty for vaults NAVC does not report on. The `*OOS` (out-of-sample, pre-vault track record) arrays are populated for hBTC only.\n","operationId":"getPerformance","parameters":[{"$ref":"#/components/parameters/VaultPath"},{"name":"range","in":"query","required":false,"description":"`1m` daily points; `3m`, `6m` weekly; `1y`, `all` monthly. Default `all`. Any other value returns `400`.","schema":{"type":"string","enum":["1m","3m","6m","1y","all"],"default":"all"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"dates":{"type":"array","items":{"type":"string"},"description":"Oldest first"},"sharePrices":{"type":"array","items":{"type":"number","nullable":true}},"tvls":{"type":"array","items":{"type":"number","nullable":true},"description":"Deposit asset"},"tvlsUsd":{"type":"array","items":{"type":"number","nullable":true}},"apys":{"type":"array","items":{"type":"number","nullable":true},"description":"%, net APY incl. Merkl rewards; 0 = no reading"},"navcNetRors":{"type":"array","items":{"type":"number"},"description":"%/yr, annualized NAVC return; 0 = no data yet"},"navcCumulativeNetRors":{"type":"array","items":{"type":"number"},"description":"%, compounded since inception"},"navcNetRorsOOSDates":{"type":"array","items":{"type":"string"},"description":"Dates for the two OOS series"},"navcNetRorsOOS":{"type":"array","items":{"type":"number"},"description":"%, trailing 12 months, pre-vault track record"},"navcCumulativeNetRorsOOS":{"type":"array","items":{"type":"number"},"description":"%"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}}},"components":{"parameters":{"VaultPath":{"name":"vault","in":"path","required":true,"description":"Vault id (UUID). `400` if malformed.","schema":{"$ref":"#/components/schemas/VaultId"}}},"schemas":{"VaultId":{"type":"string","format":"uuid"},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}},"additionalProperties":true}},"responses":{"BadRequest":{"description":"Bad input.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}
```

## Open positions across all vaults

> The account's open positions in every vault, across all chains, enriched with vault metadata, share price, net APY and PnL. A \`total\` block sums the portfolio.

```json
{"openapi":"3.0.3","info":{"title":"Syntetika Public API","version":"1.0.0"},"tags":[{"name":"Account","description":"Per-account positions, pending requests, history and rewards. Never cached."}],"servers":[{"url":"https://public.api.syntetika.io"}],"paths":{"/ember/positions/{account}":{"get":{"tags":["Account"],"summary":"Open positions across all vaults","description":"The account's open positions in every vault, across all chains, enriched with vault metadata, share price, net APY and PnL. A `total` block sums the portfolio.","operationId":"getPositions","parameters":[{"$ref":"#/components/parameters/AccountPath"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"positions":{"type":"array","items":{"$ref":"#/components/schemas/Position"}},"total":{"type":"object","properties":{"total_value":{"type":"number","description":"USD"},"net_apy":{"type":"number","nullable":true,"description":"%, value-weighted across positions"},"est_daily_yield":{"type":"number","description":"USD per day"},"return_all_time":{"type":"number","nullable":true,"description":"%, all-time yield / total_value"}}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}}},"components":{"parameters":{"AccountPath":{"name":"account","in":"path","required":true,"description":"Wallet address. `400` if not a valid address.","schema":{"$ref":"#/components/schemas/Address"}}},"schemas":{"Address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"Position":{"type":"object","properties":{"vaultId":{"type":"string"},"vaultName":{"type":"string","nullable":true},"chain":{"type":"string","enum":["base","ethereum"]},"status":{"type":"string","enum":["SYNC"]},"shares":{"type":"number","nullable":true,"description":"Receipt tokens, human units"},"shareSymbol":{"type":"string","nullable":true},"shareAddress":{"type":"string","nullable":true},"sharePrice":{"type":"number","nullable":true,"description":"Receipt-token price in deposit asset"},"netApy":{"type":"number","nullable":true,"description":"%, after fees, incl. Merkl rewards"},"pnl":{"type":"number","nullable":true,"description":"%, (realized + unrealized yield) / value"},"positionValueInCoinAmount":{"type":"number","nullable":true,"description":"Deposit asset, human units"},"positionValueUsdE9":{"type":"string","nullable":true,"description":"USD × 1e9"},"realizedYieldInCoinAmount":{"type":"string","description":"Deposit asset, raw base units"},"realizedYieldUsdE9":{"type":"string","nullable":true,"description":"USD × 1e9"},"unrealizedYieldInCoinAmount":{"type":"string","description":"Raw base units"},"unrealizedYieldUsdE9":{"type":"string","nullable":true},"totalYieldInCoinAmount":{"type":"string","description":"Raw base units"},"totalYieldUsdE9":{"type":"string","nullable":true}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}},"additionalProperties":true}},"responses":{"BadRequest":{"description":"Bad input.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}
```

## Position in one vault with entry price

> The account's position in one vault, merged with its average entry price. If the account holds no position there, only the entry-price fields are returned.

```json
{"openapi":"3.0.3","info":{"title":"Syntetika Public API","version":"1.0.0"},"tags":[{"name":"Account","description":"Per-account positions, pending requests, history and rewards. Never cached."}],"servers":[{"url":"https://public.api.syntetika.io"}],"paths":{"/ember/position/{account}/{vault}":{"get":{"tags":["Account"],"summary":"Position in one vault with entry price","description":"The account's position in one vault, merged with its average entry price. If the account holds no position there, only the entry-price fields are returned.","operationId":"getPosition","parameters":[{"$ref":"#/components/parameters/AccountPath"},{"$ref":"#/components/parameters/VaultPath"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Position"},{"type":"object","properties":{"averageEntryPriceUsd":{"type":"number","nullable":true,"description":"USD paid per share, across settled deposits"},"totalDepositedUsd":{"type":"number"},"totalSharesReceived":{"type":"number"},"depositCount":{"type":"integer"}}}]}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}}},"components":{"parameters":{"AccountPath":{"name":"account","in":"path","required":true,"description":"Wallet address. `400` if not a valid address.","schema":{"$ref":"#/components/schemas/Address"}},"VaultPath":{"name":"vault","in":"path","required":true,"description":"Vault id (UUID). `400` if malformed.","schema":{"$ref":"#/components/schemas/VaultId"}}},"schemas":{"Address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"VaultId":{"type":"string","format":"uuid"},"Position":{"type":"object","properties":{"vaultId":{"type":"string"},"vaultName":{"type":"string","nullable":true},"chain":{"type":"string","enum":["base","ethereum"]},"status":{"type":"string","enum":["SYNC"]},"shares":{"type":"number","nullable":true,"description":"Receipt tokens, human units"},"shareSymbol":{"type":"string","nullable":true},"shareAddress":{"type":"string","nullable":true},"sharePrice":{"type":"number","nullable":true,"description":"Receipt-token price in deposit asset"},"netApy":{"type":"number","nullable":true,"description":"%, after fees, incl. Merkl rewards"},"pnl":{"type":"number","nullable":true,"description":"%, (realized + unrealized yield) / value"},"positionValueInCoinAmount":{"type":"number","nullable":true,"description":"Deposit asset, human units"},"positionValueUsdE9":{"type":"string","nullable":true,"description":"USD × 1e9"},"realizedYieldInCoinAmount":{"type":"string","description":"Deposit asset, raw base units"},"realizedYieldUsdE9":{"type":"string","nullable":true,"description":"USD × 1e9"},"unrealizedYieldInCoinAmount":{"type":"string","description":"Raw base units"},"unrealizedYieldUsdE9":{"type":"string","nullable":true},"totalYieldInCoinAmount":{"type":"string","description":"Raw base units"},"totalYieldUsdE9":{"type":"string","nullable":true}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}},"additionalProperties":true}},"responses":{"BadRequest":{"description":"Bad input.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}
```

## Transaction history

> The account's vault history across all chains, newest first and paginated. Page 1 also includes Merkl reward claims, so it can hold more than \`pageSize\` rows.

```json
{"openapi":"3.0.3","info":{"title":"Syntetika Public API","version":"1.0.0"},"tags":[{"name":"Account","description":"Per-account positions, pending requests, history and rewards. Never cached."}],"servers":[{"url":"https://public.api.syntetika.io"}],"paths":{"/ember/transactions/{account}":{"get":{"tags":["Account"],"summary":"Transaction history","description":"The account's vault history across all chains, newest first and paginated. Page 1 also includes Merkl reward claims, so it can hold more than `pageSize` rows.","operationId":"getTransactions","parameters":[{"$ref":"#/components/parameters/AccountPath"},{"$ref":"#/components/parameters/Page"},{"$ref":"#/components/parameters/PageSize"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"transactions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["DepositRequest","Deposit","DepositRequestCancelled","RedeemRequest","RedeemRequestCancelled","RedeemRequestSkipped","RedeemRequestProcessed","Claim"]},"vaultId":{"type":"string","nullable":true},"vaultAddress":{"type":"string","nullable":true},"vaultName":{"type":"string","nullable":true},"vaultLogo":{"type":"string","nullable":true},"asset":{"type":"string","nullable":true,"description":"Token symbol"},"assetLogo":{"type":"string","nullable":true},"amount":{"type":"number","nullable":true,"description":"Human units of `asset`"},"amountUsd":{"type":"number","nullable":true,"description":"At the price on the transaction date"},"timestamp":{"type":"integer","nullable":true,"description":"Unix milliseconds"},"txHash":{"type":"string","nullable":true},"chain":{"type":"string"}}}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}}},"components":{"parameters":{"AccountPath":{"name":"account","in":"path","required":true,"description":"Wallet address. `400` if not a valid address.","schema":{"$ref":"#/components/schemas/Address"}},"Page":{"name":"page","in":"query","required":false,"description":"Page number, default 1.","schema":{"type":"integer","minimum":1,"default":1}},"PageSize":{"name":"pageSize","in":"query","required":false,"description":"Rows per page, default 20, max 100.","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}}},"schemas":{"Address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}},"additionalProperties":true}},"responses":{"BadRequest":{"description":"Bad input.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}
```

## Deposits waiting to settle

> The account's deposit requests that are still waiting to settle, newest first, each with its expected settlement window.

```json
{"openapi":"3.0.3","info":{"title":"Syntetika Public API","version":"1.0.0"},"tags":[{"name":"Account","description":"Per-account positions, pending requests, history and rewards. Never cached."}],"servers":[{"url":"https://public.api.syntetika.io"}],"paths":{"/ember/deposits/{account}":{"get":{"tags":["Account"],"summary":"Deposits waiting to settle","description":"The account's deposit requests that are still waiting to settle, newest first, each with its expected settlement window.","operationId":"getPendingDeposits","parameters":[{"$ref":"#/components/parameters/AccountPath"},{"$ref":"#/components/parameters/Page"},{"$ref":"#/components/parameters/PageSize"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"deposits":{"type":"array","items":{"$ref":"#/components/schemas/PendingRequest"}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}}},"components":{"parameters":{"AccountPath":{"name":"account","in":"path","required":true,"description":"Wallet address. `400` if not a valid address.","schema":{"$ref":"#/components/schemas/Address"}},"Page":{"name":"page","in":"query","required":false,"description":"Page number, default 1.","schema":{"type":"integer","minimum":1,"default":1}},"PageSize":{"name":"pageSize","in":"query","required":false,"description":"Rows per page, default 20, max 100.","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}}},"schemas":{"Address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"PendingRequest":{"type":"object","properties":{"status":{"type":"string","enum":["Awaiting Settlement","Pending","Delayed"],"description":"Before / inside / past the settlement window"},"vaultName":{"type":"string","nullable":true},"vaultLogo":{"type":"string","nullable":true},"asset":{"type":"string","nullable":true},"assetLogo":{"type":"string","nullable":true},"amount":{"type":"number","nullable":true,"description":"Deposits: asset deposited; withdrawals: always 0"},"amountUsd":{"type":"number","nullable":true,"description":"Withdrawals: always 0"},"shares":{"type":"number","nullable":true,"description":"Deposits: equals amount; withdrawals: shares redeemed"},"requestedAt":{"type":"integer","nullable":true,"description":"Unix ms"},"updatedAt":{"type":"string","nullable":true,"description":"Always null for pending requests"},"processedAt":{"type":"string","nullable":true,"description":"Always null for pending requests"},"settle_date":{"type":"integer","nullable":true,"description":"Settlement window opens, unix ms"},"settle_date_max":{"type":"integer","nullable":true,"description":"Window closes; after this the request is Delayed"},"wait_period":{"type":"integer","nullable":true,"description":"Seconds until settle_date, floored at 0"},"txHash":{"type":"string","nullable":true},"chain":{"type":"string"},"sequenceNumber":{"type":"integer","nullable":true}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}},"additionalProperties":true}},"responses":{"BadRequest":{"description":"Bad input.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}
```

## Redemptions waiting to settle

> The account's redemption requests that are still waiting to settle, newest first. Same shape as \`/ember/deposits\`.

```json
{"openapi":"3.0.3","info":{"title":"Syntetika Public API","version":"1.0.0"},"tags":[{"name":"Account","description":"Per-account positions, pending requests, history and rewards. Never cached."}],"servers":[{"url":"https://public.api.syntetika.io"}],"paths":{"/ember/withdrawals/{account}":{"get":{"tags":["Account"],"summary":"Redemptions waiting to settle","description":"The account's redemption requests that are still waiting to settle, newest first. Same shape as `/ember/deposits`.","operationId":"getPendingWithdrawals","parameters":[{"$ref":"#/components/parameters/AccountPath"},{"$ref":"#/components/parameters/Page"},{"$ref":"#/components/parameters/PageSize"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"withdrawals":{"type":"array","items":{"$ref":"#/components/schemas/PendingRequest"}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}}},"components":{"parameters":{"AccountPath":{"name":"account","in":"path","required":true,"description":"Wallet address. `400` if not a valid address.","schema":{"$ref":"#/components/schemas/Address"}},"Page":{"name":"page","in":"query","required":false,"description":"Page number, default 1.","schema":{"type":"integer","minimum":1,"default":1}},"PageSize":{"name":"pageSize","in":"query","required":false,"description":"Rows per page, default 20, max 100.","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}}},"schemas":{"Address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"PendingRequest":{"type":"object","properties":{"status":{"type":"string","enum":["Awaiting Settlement","Pending","Delayed"],"description":"Before / inside / past the settlement window"},"vaultName":{"type":"string","nullable":true},"vaultLogo":{"type":"string","nullable":true},"asset":{"type":"string","nullable":true},"assetLogo":{"type":"string","nullable":true},"amount":{"type":"number","nullable":true,"description":"Deposits: asset deposited; withdrawals: always 0"},"amountUsd":{"type":"number","nullable":true,"description":"Withdrawals: always 0"},"shares":{"type":"number","nullable":true,"description":"Deposits: equals amount; withdrawals: shares redeemed"},"requestedAt":{"type":"integer","nullable":true,"description":"Unix ms"},"updatedAt":{"type":"string","nullable":true,"description":"Always null for pending requests"},"processedAt":{"type":"string","nullable":true,"description":"Always null for pending requests"},"settle_date":{"type":"integer","nullable":true,"description":"Settlement window opens, unix ms"},"settle_date_max":{"type":"integer","nullable":true,"description":"Window closes; after this the request is Delayed"},"wait_period":{"type":"integer","nullable":true,"description":"Seconds until settle_date, floored at 0"},"txHash":{"type":"string","nullable":true},"chain":{"type":"string"},"sequenceNumber":{"type":"integer","nullable":true}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}},"additionalProperties":true}},"responses":{"BadRequest":{"description":"Bad input.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}
```

## Merkl rewards and claim proofs

> The account's Merkl rewards on one chain, fetched live from the Merkl API and limited to campaigns for Syntetika vaults. Each reward includes the proof needed to claim it from the Merkl distributor.

```json
{"openapi":"3.0.3","info":{"title":"Syntetika Public API","version":"1.0.0"},"tags":[{"name":"Account","description":"Per-account positions, pending requests, history and rewards. Never cached."}],"servers":[{"url":"https://public.api.syntetika.io"}],"paths":{"/ember/rewards/{account}":{"get":{"tags":["Account"],"summary":"Merkl rewards and claim proofs","description":"The account's Merkl rewards on one chain, fetched live from the Merkl API and limited to campaigns for Syntetika vaults. Each reward includes the proof needed to claim it from the Merkl distributor.","operationId":"getRewards","parameters":[{"$ref":"#/components/parameters/AccountPath"},{"name":"chain","in":"query","required":false,"description":"`base`, `ethereum` or a numeric chain id. Default `base`.","schema":{"type":"string","default":"base"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"chainId":{"type":"integer"},"distributor":{"type":"string","description":"Merkl Distributor contract to claim from"},"rewards":{"type":"array","items":{"type":"object","properties":{"token":{"type":"string","nullable":true,"description":"Reward token address"},"symbol":{"type":"string","nullable":true},"decimals":{"type":"integer","nullable":true},"logoUrl":{"type":"string","nullable":true},"amount":{"type":"string","description":"Raw base units, lifetime total"},"claimed":{"type":"string","description":"Raw base units"},"unclaimed":{"type":"string","description":"Raw base units"},"unclaimedUsd":{"type":"number","nullable":true},"proof":{"type":"array","items":{"type":"string"}}}}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}}},"components":{"parameters":{"AccountPath":{"name":"account","in":"path","required":true,"description":"Wallet address. `400` if not a valid address.","schema":{"$ref":"#/components/schemas/Address"}}},"schemas":{"Address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}},"additionalProperties":true}},"responses":{"BadRequest":{"description":"Bad input.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}
```

## NAV strike history

> History of NAV strikes for a fund, optionally limited to a date window. A strike is served only once its rate has been pushed on-chain.

```json
{"openapi":"3.0.3","info":{"title":"Syntetika Public API","version":"1.0.0"},"tags":[{"name":"NAVC","description":"NAV attestations from NAV Consulting. Never cached. A strike is served only once its rate is on-chain."}],"servers":[{"url":"https://public.api.syntetika.io"}],"paths":{"/navc/history":{"get":{"tags":["NAVC"],"summary":"NAV strike history","description":"History of NAV strikes for a fund, optionally limited to a date window. A strike is served only once its rate has been pushed on-chain.","operationId":"getNavHistory","parameters":[{"name":"from","in":"query","required":false,"description":"`YYYY-MM-DD`, inclusive. Invalid values are ignored.","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"description":"`YYYY-MM-DD`, inclusive. Invalid values are ignored.","schema":{"type":"string","format":"date"}},{"$ref":"#/components/parameters/VaultQuery"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"points":{"type":"array","items":{"type":"object","properties":{"t":{"type":"integer","description":"Strike date, unix seconds"},"v":{"type":"number","description":"NAV"},"eb":{"type":"number","nullable":true,"description":"Ending balance"},"finalizedAt":{"type":"integer","nullable":true,"description":"When the rate was pushed on-chain, unix seconds"}}}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}}},"components":{"parameters":{"VaultQuery":{"name":"vault","in":"query","required":false,"description":"Vault id. Default hBTC. A malformed id returns `400`; a vault NAVC does not report on gets an empty result.","schema":{"$ref":"#/components/schemas/VaultId"}}},"schemas":{"VaultId":{"type":"string","format":"uuid"},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}},"additionalProperties":true}},"responses":{"BadRequest":{"description":"Bad input.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}
```

## GET /navc/latest

> Latest NAV attestation

```json
{"openapi":"3.0.3","info":{"title":"Syntetika Public API","version":"1.0.0"},"tags":[{"name":"NAVC","description":"NAV attestations from NAV Consulting. Never cached. A strike is served only once its rate is on-chain."}],"servers":[{"url":"https://public.api.syntetika.io"}],"paths":{"/navc/latest":{"get":{"tags":["NAVC"],"summary":"Latest NAV attestation","operationId":"getNavLatest","parameters":[{"$ref":"#/components/parameters/VaultQuery"}],"responses":{"200":{"description":"OK. `null` when there is no attestation yet.","content":{"application/json":{"schema":{"type":"object","nullable":true,"properties":{"date":{"type":"string","format":"date"},"nav":{"type":"number"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}}},"components":{"parameters":{"VaultQuery":{"name":"vault","in":"query","required":false,"description":"Vault id. Default hBTC. A malformed id returns `400`; a vault NAVC does not report on gets an empty result.","schema":{"$ref":"#/components/schemas/VaultId"}}},"schemas":{"VaultId":{"type":"string","format":"uuid"},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}},"additionalProperties":true}},"responses":{"BadRequest":{"description":"Bad input.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}
```

## Where the fund is in its attestation cycle

> Latest and previous NAV, the next strike, the window when its attestation is expected, and the latest period's return.

```json
{"openapi":"3.0.3","info":{"title":"Syntetika Public API","version":"1.0.0"},"tags":[{"name":"NAVC","description":"NAV attestations from NAV Consulting. Never cached. A strike is served only once its rate is on-chain."}],"servers":[{"url":"https://public.api.syntetika.io"}],"paths":{"/navc/period":{"get":{"tags":["NAVC"],"summary":"Where the fund is in its attestation cycle","description":"Latest and previous NAV, the next strike, the window when its attestation is expected, and the latest period's return.","operationId":"getNavPeriod","parameters":[{"$ref":"#/components/parameters/VaultQuery"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"latestAttestationDate":{"type":"string","nullable":true},"latestNav":{"type":"number","nullable":true},"previousNav":{"type":"number","nullable":true},"nextNavStrikeDate":{"type":"string","nullable":true},"nextAttestationDate":{"type":"string","nullable":true,"description":"Earliest expected delivery"},"nextAttestationDateMax":{"type":"string","nullable":true,"description":"Latest expected delivery"},"daysUntilNext":{"type":"integer","nullable":true},"daysUntilNextMax":{"type":"integer","nullable":true},"overdue":{"type":"boolean","description":"Window passed with no attestation"},"dayOfPeriod":{"type":"integer","nullable":true},"periodLengthDays":{"type":"integer"},"periodReturn":{"type":"number","nullable":true,"description":"Decimal, latest vs previous NAV"},"annualizedReturn":{"type":"number","nullable":true,"description":"Decimal"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}}},"components":{"parameters":{"VaultQuery":{"name":"vault","in":"query","required":false,"description":"Vault id. Default hBTC. A malformed id returns `400`; a vault NAVC does not report on gets an empty result.","schema":{"$ref":"#/components/schemas/VaultId"}}},"schemas":{"VaultId":{"type":"string","format":"uuid"},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}},"additionalProperties":true}},"responses":{"BadRequest":{"description":"Bad input.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}
```

## NAVC integration status (diagnostic)

> Whether the integration is configured, the latest attestation, the last fetch error and the on-chain rate gate. Always reports the default (hBTC) fund.

```json
{"openapi":"3.0.3","info":{"title":"Syntetika Public API","version":"1.0.0"},"tags":[{"name":"NAVC","description":"NAV attestations from NAV Consulting. Never cached. A strike is served only once its rate is on-chain."}],"servers":[{"url":"https://public.api.syntetika.io"}],"paths":{"/navc/status":{"get":{"tags":["NAVC"],"summary":"NAVC integration status (diagnostic)","description":"Whether the integration is configured, the latest attestation, the last fetch error and the on-chain rate gate. Always reports the default (hBTC) fund.","operationId":"getNavStatus","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"configured":{"type":"boolean"},"provider":{"type":"string","enum":["NAV Consulting"]},"fundId":{"type":"string"},"apiKeyFingerprint":{"type":"string","nullable":true,"description":"First 8 hex chars of sha256(api key)"},"latestAttestationDate":{"type":"string","nullable":true},"latestNav":{"type":"number","nullable":true},"latestEndingBalance":{"type":"number","nullable":true},"attestationsCount":{"type":"integer"},"window":{"type":"object","nullable":true,"description":"Last query window","properties":{"from":{"type":"string"},"to":{"type":"string"}}},"lastError":{"type":"string","nullable":true},"rateGate":{"type":"object","properties":{"lastRateUpdate":{"type":"string","nullable":true,"description":"Last on-chain rate push"},"pendingCount":{"type":"integer","description":"Strikes withheld until the rate is pushed"},"pendingDates":{"type":"array","items":{"type":"string"}},"rawAttestationsCount":{"type":"integer","description":"Count before withholding"},"vaults":{"type":"array","items":{"type":"object","properties":{"vaultId":{"type":"string"},"chain":{"type":"string"},"lastUpdate":{"type":"string","nullable":true,"format":"date-time"}}}}}}}}}}}}}}}}
```

## Investor statement PDF

> Downloads the investor statement PDF for a month. If that month's NAV is not on-chain yet, the route can serve the latest earlier statement that is, and says so in the response headers.

```json
{"openapi":"3.0.3","info":{"title":"Syntetika Public API","version":"1.0.0"},"tags":[{"name":"NAVC","description":"NAV attestations from NAV Consulting. Never cached. A strike is served only once its rate is on-chain."}],"servers":[{"url":"https://public.api.syntetika.io"}],"paths":{"/navc/statement":{"get":{"tags":["NAVC"],"summary":"Investor statement PDF","description":"Downloads the investor statement PDF for a month. If that month's NAV is not on-chain yet, the route can serve the latest earlier statement that is, and says so in the response headers.","operationId":"getNavStatement","parameters":[{"name":"year","in":"query","required":true,"schema":{"type":"integer","minimum":2000,"maximum":2100}},{"name":"month","in":"query","required":true,"schema":{"type":"integer","minimum":1,"maximum":12}},{"name":"date","in":"query","required":false,"description":"`YYYY-MM-DD` inside that month. Picks one strike when the month has two.","schema":{"type":"string","format":"date"}},{"name":"index","in":"query","required":false,"description":"Position of the statement within the month, `0` or higher.","schema":{"type":"integer","minimum":0}},{"name":"file","in":"query","required":false,"description":"Exact statement file name.","schema":{"type":"string"}},{"$ref":"#/components/parameters/VaultQuery"}],"responses":{"200":{"description":"The PDF, sent as an attachment.","headers":{"Content-Disposition":{"schema":{"type":"string"},"description":"`attachment; filename=\"...\"`"},"X-Statement-Count":{"schema":{"type":"integer"},"description":"Number of statements available for the served month."},"X-Statement-Month":{"schema":{"type":"string"},"description":"`YYYY-MM` actually served."},"X-Statement-Substituted":{"schema":{"type":"string"},"description":"`\"true\"` when an earlier statement was served instead."}},"content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"No statement has been published, or (`pendingRateUpdate: true`) a statement is published but its rate is not on-chain yet.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Error"},{"type":"object","properties":{"pendingRateUpdate":{"type":"boolean"}}}]}}}},"429":{"description":"NAVC's rate limit was hit."}}}}},"components":{"parameters":{"VaultQuery":{"name":"vault","in":"query","required":false,"description":"Vault id. Default hBTC. A malformed id returns `400`; a vault NAVC does not report on gets an empty result.","schema":{"$ref":"#/components/schemas/VaultId"}}},"schemas":{"VaultId":{"type":"string","format":"uuid"},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}},"additionalProperties":true}}}}
```

## Vault factsheet PDF

> The vault's factsheet PDF for display inline. Only some vaults have one.

```json
{"openapi":"3.0.3","info":{"title":"Syntetika Public API","version":"1.0.0"},"tags":[{"name":"Factsheet","description":"Vault factsheet PDFs."}],"servers":[{"url":"https://public.api.syntetika.io"}],"paths":{"/factsheet/{vault}":{"get":{"tags":["Factsheet"],"summary":"Vault factsheet PDF","description":"The vault's factsheet PDF for display inline. Only some vaults have one.","operationId":"getFactsheet","parameters":[{"$ref":"#/components/parameters/VaultPath"}],"responses":{"200":{"description":"The PDF, sent inline with `Cache-Control: public, max-age=300`.","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"}}}}},"components":{"parameters":{"VaultPath":{"name":"vault","in":"path","required":true,"description":"Vault id (UUID). `400` if malformed.","schema":{"$ref":"#/components/schemas/VaultId"}}},"schemas":{"VaultId":{"type":"string","format":"uuid"},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}},"additionalProperties":true}},"responses":{"BadRequest":{"description":"Bad input.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"Not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}
```

## Merkl campaign APRs

> Merkl reward-campaign APRs matched to the vault tokens, optionally narrowed to one vault.

```json
{"openapi":"3.0.3","info":{"title":"Syntetika Public API","version":"1.0.0"},"tags":[{"name":"Merkl","description":"Merkl reward campaigns matched to the vault tokens."}],"servers":[{"url":"https://public.api.syntetika.io"}],"paths":{"/merkl/apr":{"get":{"tags":["Merkl"],"summary":"Merkl campaign APRs","description":"Merkl reward-campaign APRs matched to the vault tokens, optionally narrowed to one vault.","operationId":"getMerklApr","parameters":[{"name":"vault","in":"query","required":false,"description":"Vault id.","schema":{"$ref":"#/components/schemas/VaultId"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"opportunities":{"type":"array","items":{"type":"object","properties":{"opportunityId":{"type":"string"},"vaultId":{"type":"string","nullable":true},"chainId":{"type":"integer","nullable":true},"identifier":{"type":"string","nullable":true,"description":"Target token address"},"name":{"type":"string","nullable":true},"status":{"type":"string","nullable":true,"description":"e.g. \"LIVE\""},"apr":{"type":"number","nullable":true,"description":"%"},"totalApr":{"type":"number","nullable":true},"maxApr":{"type":"number","nullable":true},"tvl":{"type":"number","nullable":true},"dailyRewards":{"type":"number","nullable":true},"matchedToken":{"type":"string","nullable":true},"lastSynced":{"type":"string","nullable":true,"format":"date-time"}}}}}}}}}}}}},"components":{"schemas":{"VaultId":{"type":"string","format":"uuid"}}}}
```

## Native APR feed for Merkl

> The vaults' native APR (after fees, excluding Merkl rewards) in the format Merkl's native-APR integration polls. The response is a top-level array, as Merkl requires.

```json
{"openapi":"3.0.3","info":{"title":"Syntetika Public API","version":"1.0.0"},"tags":[{"name":"Merkl","description":"Merkl reward campaigns matched to the vault tokens."}],"servers":[{"url":"https://public.api.syntetika.io"}],"paths":{"/merkl/native-apr":{"get":{"tags":["Merkl"],"summary":"Native APR feed for Merkl","description":"The vaults' native APR (after fees, excluding Merkl rewards) in the format Merkl's native-APR integration polls. The response is a top-level array, as Merkl requires.","operationId":"getMerklNativeApr","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"opportunityId":{"type":"string"},"timestamp":{"type":"integer","description":"Unix seconds"},"value":{"type":"number","description":"%"},"description":{"type":"string"}}}}}}}}}}}}
```

## Dashboard headline numbers

> Protocol TVL and its 30-day change, queued deposits and exits, and the latest and next NAV attestation.

```json
{"openapi":"3.0.3","info":{"title":"Syntetika Public API","version":"1.0.0"},"tags":[{"name":"Transparency","description":"Data behind the public transparency dashboard. Cached."}],"servers":[{"url":"https://public.api.syntetika.io"}],"paths":{"/transparency/overview":{"get":{"tags":["Transparency"],"summary":"Dashboard headline numbers","description":"Protocol TVL and its 30-day change, queued deposits and exits, and the latest and next NAV attestation.","operationId":"getTransparencyOverview","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tvl":{"type":"object","properties":{"totalUsd":{"type":"number"},"change30d":{"type":"object","nullable":true,"properties":{"usd":{"type":"number"},"pct":{"type":"number"}}},"fundsCount":{"type":"integer"},"funds":{"type":"array","items":{"$ref":"#/components/schemas/FundTvl"}}}},"queuedDeposits":{"type":"object","properties":{"usd":{"type":"number"},"requests":{"type":"integer"},"nextCutoff":{"type":"integer"},"nextCutoffDate":{"type":"string","format":"date-time"},"nextStrike":{"type":"integer"},"nextStrikeDate":{"type":"string"}}},"queuedExits":{"type":"object","properties":{"usd":{"type":"number"},"requests":{"type":"integer"}}},"latestAttestation":{"type":"object","nullable":true,"properties":{"strikeDate":{"type":"string"},"publishedAt":{"type":"integer","nullable":true},"vaultId":{"type":"string"},"vaultName":{"type":"string","nullable":true},"provider":{"type":"string","enum":["NAV Consulting"]}}},"nextNavStrike":{"type":"integer"},"nextNavStrikeDate":{"type":"string"}}}}}}}}}},"components":{"schemas":{"FundTvl":{"type":"object","properties":{"vaultId":{"type":"string"},"name":{"type":"string","nullable":true},"chain":{"type":"string","nullable":true},"tvlUsd":{"type":"number"},"sharePct":{"type":"number","description":"% of total protocol TVL"}}}}}}
```

## Protocol TVL history

> Daily protocol TVL since launch, as a total and per fund, plus markers for NAV publications. Histories longer than about 400 days are thinned to weekly points.

```json
{"openapi":"3.0.3","info":{"title":"Syntetika Public API","version":"1.0.0"},"tags":[{"name":"Transparency","description":"Data behind the public transparency dashboard. Cached."}],"servers":[{"url":"https://public.api.syntetika.io"}],"paths":{"/transparency/tvl":{"get":{"tags":["Transparency"],"summary":"Protocol TVL history","description":"Daily protocol TVL since launch, as a total and per fund, plus markers for NAV publications. Histories longer than about 400 days are thinned to weekly points.","operationId":"getTransparencyTvl","parameters":[{"name":"range","in":"query","required":false,"schema":{"type":"string","enum":["1m","3m","6m","1y","all"],"default":"all"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"range":{"type":"string","enum":["1m","3m","6m","1y","all"]},"dates":{"type":"array","items":{"type":"string"}},"total":{"type":"array","items":{"type":"number","nullable":true},"description":"USD, aligned with dates"},"funds":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/FundTvl"},{"type":"object","properties":{"series":{"type":"array","items":{"type":"number","nullable":true},"description":"USD per date"}}}]}},"totalTvlUsd":{"type":"number","description":"Live"},"change":{"type":"object","nullable":true,"description":"Since the first point","properties":{"from":{"type":"string"},"usd":{"type":"number"},"pct":{"type":"number"}}},"navPublished":{"type":"array","items":{"type":"object","properties":{"vaultId":{"type":"string"},"strikeDate":{"type":"string"},"publishedAt":{"type":"integer"}}}}}}}}}}}}},"components":{"schemas":{"FundTvl":{"type":"object","properties":{"vaultId":{"type":"string"},"name":{"type":"string","nullable":true},"chain":{"type":"string","nullable":true},"tvlUsd":{"type":"number"},"sharePct":{"type":"number","description":"% of total protocol TVL"}}}}}}
```

## Queues for the next strike

> For each fund, what is queued for the next NAV strike, the cycle's timeline, the last settled cohort, and block-explorer links to the fund's contracts.

```json
{"openapi":"3.0.3","info":{"title":"Syntetika Public API","version":"1.0.0"},"tags":[{"name":"Transparency","description":"Data behind the public transparency dashboard. Cached."}],"servers":[{"url":"https://public.api.syntetika.io"}],"paths":{"/transparency/queues":{"get":{"tags":["Transparency"],"summary":"Queues for the next strike","description":"For each fund, what is queued for the next NAV strike, the cycle's timeline, the last settled cohort, and block-explorer links to the fund's contracts.","operationId":"getTransparencyQueues","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"summary":{"type":"object","properties":{"fundsCount":{"type":"integer"},"inUsd":{"type":"number"},"outUsd":{"type":"number"},"netUsd":{"type":"number"},"requests":{"type":"integer"}}},"funds":{"type":"array","items":{"type":"object","properties":{"vaultId":{"type":"string"},"name":{"type":"string","nullable":true},"chain":{"type":"string"},"strikesPerMonth":{"type":"integer"},"nextCutoff":{"type":"integer"},"nextStrike":{"type":"integer"},"nextStrikeDate":{"type":"string"},"deposits":{"allOf":[{"$ref":"#/components/schemas/Flow"}],"description":"Amount in deposit asset"},"exits":{"allOf":[{"$ref":"#/components/schemas/Flow"}],"description":"Amount in shares"},"netFlowUsd":{"type":"number","nullable":true},"timeline":{"type":"object","properties":{"queueOpen":{"type":"object","properties":{"depositsOpen":{"type":"boolean","nullable":true},"cancellable":{"type":"boolean","nullable":true}}},"cutoff":{"type":"integer"},"cutoffSource":{"type":"string","enum":["scheduled","rule"]},"strike":{"type":"integer"},"navPublishedEst":{"type":"object","properties":{"expected":{"type":"integer"},"latest":{"type":"integer"}}},"settlementEst":{"type":"object","properties":{"from":{"type":"integer"},"to":{"type":"integer"}}}}},"lastCohort":{"type":"object","nullable":true,"allOf":[{"$ref":"#/components/schemas/Cohort"}]},"links":{"type":"object","properties":{"depositQueue":{"type":"string","nullable":true,"description":"Block-explorer URL"},"vaultContract":{"type":"string","nullable":true,"description":"Block-explorer URL"}}},"contracts":{"type":"object","properties":{"depositQueue":{"type":"string","nullable":true},"vault":{"type":"string"}}}}}}}}}}}}}}},"components":{"schemas":{"Flow":{"type":"object","properties":{"amount":{"type":"number"},"symbol":{"type":"string","nullable":true},"usd":{"type":"number","nullable":true},"requests":{"type":"integer"}}},"Cohort":{"type":"object","description":"A batch of settled requests, grouped by the NAV that priced them.","properties":{"strikeDate":{"type":"string","nullable":true},"strike":{"type":"integer","nullable":true},"publishedAt":{"type":"integer","nullable":true},"settledAt":{"type":"integer"},"navPerShare":{"type":"number","nullable":true},"deposits":{"$ref":"#/components/schemas/CohortDeposits"},"exits":{"$ref":"#/components/schemas/CohortExits"}}},"CohortDeposits":{"type":"object","properties":{"assets":{"type":"number"},"requests":{"type":"integer"}}},"CohortExits":{"type":"object","properties":{"assets":{"type":"number"},"shares":{"type":"number"},"requests":{"type":"integer"}}}}}}
```

## Recent requests

> The most recent deposit and exit requests across all funds, plus the count of requests still open.

```json
{"openapi":"3.0.3","info":{"title":"Syntetika Public API","version":"1.0.0"},"tags":[{"name":"Transparency","description":"Data behind the public transparency dashboard. Cached."}],"servers":[{"url":"https://public.api.syntetika.io"}],"paths":{"/transparency/requests":{"get":{"tags":["Transparency"],"summary":"Recent requests","description":"The most recent deposit and exit requests across all funds, plus the count of requests still open.","operationId":"getTransparencyRequests","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":20,"default":10}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"openRequests":{"type":"integer"},"requests":{"type":"array","items":{"type":"object","properties":{"time":{"type":"integer"},"vaultId":{"type":"string"},"fund":{"type":"string","nullable":true},"chain":{"type":"string"},"type":{"type":"string","enum":["deposit","exit"]},"amount":{"type":"number","description":"Deposit asset for deposits, shares for exits"},"symbol":{"type":"string","nullable":true},"amountUsd":{"type":"number","nullable":true},"account":{"type":"string"},"status":{"type":"string","enum":["queued","settled","cancelled"]},"txHash":{"type":"string"}}}}}}}}}}}}}}
```

## NAV attestation statements

> Every NAV attestation statement per fund, newest first, each cross-checked against the on-chain price and the vault's assets. Optionally filtered to one month.

```json
{"openapi":"3.0.3","info":{"title":"Syntetika Public API","version":"1.0.0"},"tags":[{"name":"Transparency","description":"Data behind the public transparency dashboard. Cached."}],"servers":[{"url":"https://public.api.syntetika.io"}],"paths":{"/transparency/attestations":{"get":{"tags":["Transparency"],"summary":"NAV attestation statements","description":"Every NAV attestation statement per fund, newest first, each cross-checked against the on-chain price and the vault's assets. Optionally filtered to one month.","operationId":"getTransparencyAttestations","parameters":[{"name":"month","in":"query","required":false,"description":"`YYYY-MM`","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"nextStrikes":{"type":"array","items":{"type":"object","properties":{"vaultId":{"type":"string"},"fund":{"type":"string","nullable":true},"nextStrike":{"type":"integer"},"nextStrikeDate":{"type":"string"},"statementExpected":{"type":"object","properties":{"expected":{"type":"integer"},"latest":{"type":"integer"}}}}}},"publicationLag":{"type":"object","properties":{"expectedBusinessDays":{"type":"integer"},"maxBusinessDays":{"type":"integer"}}},"months":{"type":"array","items":{"type":"string"},"description":"Every YYYY-MM with statements (ignores the filter)"},"count":{"type":"integer"},"statements":{"type":"array","items":{"type":"object","properties":{"strikeDate":{"type":"string"},"vaultId":{"type":"string"},"fund":{"type":"string","nullable":true},"chain":{"type":"string"},"navPerShare":{"type":"number","nullable":true},"endingBalance":{"type":"object","properties":{"amount":{"type":"number","nullable":true},"symbol":{"type":"string","nullable":true},"usd":{"type":"number","nullable":true}}},"periodReturnPct":{"type":"number","nullable":true,"description":"%"},"publishedAt":{"type":"integer","nullable":true,"description":"When published on-chain"},"businessDaysAfterStrike":{"type":"integer","nullable":true},"statementUrl":{"type":"string","description":"Relative link to /navc/statement"},"periodCovered":{"type":"object","properties":{"from":{"type":"string","nullable":true},"to":{"type":"string"}}},"administrator":{"type":"string","enum":["NAV Consulting"]},"onChainPrice":{"type":"object","properties":{"atStrike":{"type":"number","nullable":true},"attested":{"type":"number","nullable":true},"differencePct":{"type":"number","nullable":true}}},"vaultAssets":{"type":"object","properties":{"onChain":{"type":"number","nullable":true},"attested":{"type":"number","nullable":true},"differencePct":{"type":"number","nullable":true}}},"cohort":{"type":"object","nullable":true,"properties":{"deposits":{"$ref":"#/components/schemas/CohortDeposits"},"exits":{"$ref":"#/components/schemas/CohortExits"}}},"vaultExplorerUrl":{"type":"string","nullable":true}}}}}}}}}}}}},"components":{"schemas":{"CohortDeposits":{"type":"object","properties":{"assets":{"type":"number"},"requests":{"type":"integer"}}},"CohortExits":{"type":"object","properties":{"assets":{"type":"number"},"shares":{"type":"number"},"requests":{"type":"integer"}}}}}}
```

## GET /transparency/factsheets

> Factsheets per fund

```json
{"openapi":"3.0.3","info":{"title":"Syntetika Public API","version":"1.0.0"},"tags":[{"name":"Transparency","description":"Data behind the public transparency dashboard. Cached."}],"servers":[{"url":"https://public.api.syntetika.io"}],"paths":{"/transparency/factsheets":{"get":{"tags":["Transparency"],"summary":"Factsheets per fund","operationId":"getTransparencyFactsheets","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"funds":{"type":"array","items":{"type":"object","properties":{"vaultId":{"type":"string"},"name":{"type":"string","nullable":true},"chain":{"type":"string"},"factsheet":{"type":"object","nullable":true,"properties":{"url":{"type":"string","description":"Relative link to /factsheet/{vault}"},"fileName":{"type":"string"},"sizeBytes":{"type":"integer"},"updatedAt":{"type":"integer"}}}}}}}}}}}}}}}}
```

## Allocation across external protocols

> How each fund's assets are split between external DeFi protocols (Pendle, Royco) and idle holdings, per fund and combined. The \`holding\` slice always comes last.

```json
{"openapi":"3.0.3","info":{"title":"Syntetika Public API","version":"1.0.0"},"tags":[{"name":"Transparency","description":"Data behind the public transparency dashboard. Cached."}],"servers":[{"url":"https://public.api.syntetika.io"}],"paths":{"/transparency/allocation":{"get":{"tags":["Transparency"],"summary":"Allocation across external protocols","description":"How each fund's assets are split between external DeFi protocols (Pendle, Royco) and idle holdings, per fund and combined. The `holding` slice always comes last.","operationId":"getTransparencyAllocation","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"totalUsd":{"type":"number"},"inOpportunities":{"$ref":"#/components/schemas/UsdPct"},"holding":{"$ref":"#/components/schemas/UsdPct"},"slices":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"name":{"type":"string"},"usd":{"type":"number"},"pct":{"type":"number"}}}},"funds":{"type":"array","items":{"type":"object","properties":{"vaultId":{"type":"string"},"name":{"type":"string","nullable":true},"chain":{"type":"string"},"symbol":{"type":"string","nullable":true},"totalUsd":{"type":"number"},"inOpportunities":{"$ref":"#/components/schemas/UsdPct"},"holding":{"$ref":"#/components/schemas/UsdPct"},"slices":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","enum":["pendle","royco","holding"]},"name":{"type":"string"},"amount":{"type":"number","nullable":true,"description":"Deposit asset"},"usd":{"type":"number"},"pct":{"type":"number","description":"% of the fund"},"contracts":{"type":"array","items":{"type":"string"}}}}}}}}}}}}}}}}},"components":{"schemas":{"UsdPct":{"type":"object","properties":{"usd":{"type":"number"},"pct":{"type":"number"}}}}}}
```

## Build a swap transaction

> A ready-to-sign transaction that swaps one token for another through Enso's router. Send any \`preTransactions\` (approvals) before \`tx\`.

```json
{"openapi":"3.0.3","info":{"title":"Syntetika Public API","version":"1.0.0"},"tags":[{"name":"Enso","description":"Ready-to-sign swap and zap transactions built through Enso. Never cached."}],"servers":[{"url":"https://public.api.syntetika.io"}],"paths":{"/enso/swap":{"get":{"tags":["Enso"],"summary":"Build a swap transaction","description":"A ready-to-sign transaction that swaps one token for another through Enso's router. Send any `preTransactions` (approvals) before `tx`.","operationId":"buildSwap","parameters":[{"name":"tokenIn","in":"query","required":true,"description":"Token address to sell.","schema":{"$ref":"#/components/schemas/Address"}},{"name":"tokenOut","in":"query","required":true,"description":"Token address to buy. Must differ from `tokenIn`.","schema":{"$ref":"#/components/schemas/Address"}},{"name":"amountIn","in":"query","required":true,"description":"Amount to sell, positive integer in base units.","schema":{"type":"string"}},{"name":"fromAddress","in":"query","required":true,"description":"Signer address.","schema":{"$ref":"#/components/schemas/Address"}},{"name":"receiver","in":"query","required":false,"description":"Recipient. Defaults to `fromAddress`.","schema":{"$ref":"#/components/schemas/Address"}},{"$ref":"#/components/parameters/Slippage"},{"$ref":"#/components/parameters/ChainQuery"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"chainId":{"type":"integer"},"tx":{"$ref":"#/components/schemas/Tx"},"preTransactions":{"$ref":"#/components/schemas/PreTransactions"},"gas":{"type":"string"},"route":{"type":"array","items":{"$ref":"#/components/schemas/RouteLeg"}},"priceImpact":{"type":"number","nullable":true},"tokenIn":{"type":"string"},"tokenOut":{"type":"string"},"amountIn":{"type":"string"},"amountOut":{"type":"string","nullable":true,"description":"Base units"},"minAmountOut":{"type":"string","nullable":true,"description":"Base units, after slippage"},"slippageBps":{"type":"integer"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"503":{"$ref":"#/components/responses/NotConfigured"}}}}},"components":{"schemas":{"Address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"Tx":{"type":"object","properties":{"to":{"type":"string"},"from":{"type":"string"},"data":{"type":"string"},"value":{"type":"string"}}},"PreTransactions":{"type":"array","description":"Land these before `tx`.","items":{"type":"object","properties":{"type":{"type":"string"},"tx":{"$ref":"#/components/schemas/Tx"}}}},"RouteLeg":{"type":"object","properties":{"action":{"type":"string"},"protocol":{"type":"string"},"tokenIn":{"type":"array","items":{"type":"string"}},"tokenOut":{"type":"array","items":{"type":"string"}},"chainId":{"type":"integer"}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}},"additionalProperties":true}},"parameters":{"Slippage":{"name":"slippage","in":"query","required":false,"description":"Basis points, 0 to 5000. Default 100.","schema":{"type":"integer","minimum":0,"maximum":5000,"default":100}},"ChainQuery":{"name":"chain","in":"query","required":false,"description":"Chain name or id. Default `base`.","schema":{"type":"string","default":"base"}}},"responses":{"BadRequest":{"description":"Bad input.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotConfigured":{"description":"The feature is not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}
```

## Build a deposit-from-any-token transaction

> One transaction that swaps any token into a vault's deposit asset and submits a deposit request. Shares are minted when the request settles, not by this transaction. The quote does not check the signer's balance.

```json
{"openapi":"3.0.3","info":{"title":"Syntetika Public API","version":"1.0.0"},"tags":[{"name":"Enso","description":"Ready-to-sign swap and zap transactions built through Enso. Never cached."}],"servers":[{"url":"https://public.api.syntetika.io"}],"paths":{"/enso/zap":{"get":{"tags":["Enso"],"summary":"Build a deposit-from-any-token transaction","description":"One transaction that swaps any token into a vault's deposit asset and submits a deposit request. Shares are minted when the request settles, not by this transaction. The quote does not check the signer's balance.","operationId":"buildZap","parameters":[{"name":"vault","in":"query","required":true,"description":"Vault id or vault contract address. `400` if the vault is not on `chain`.","schema":{"type":"string"}},{"name":"depositManager","in":"query","required":true,"description":"Address of the vault's deposit-request contract.","schema":{"$ref":"#/components/schemas/Address"}},{"name":"tokenIn","in":"query","required":true,"description":"Token address to pay with. Use `0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee` for native ETH.","schema":{"$ref":"#/components/schemas/Address"}},{"name":"amountIn","in":"query","required":true,"description":"Positive integer in base units.","schema":{"type":"string"}},{"name":"fromAddress","in":"query","required":true,"description":"Signer address.","schema":{"$ref":"#/components/schemas/Address"}},{"name":"receiver","in":"query","required":false,"description":"Who the shares are for. Defaults to `fromAddress`.","schema":{"$ref":"#/components/schemas/Address"}},{"$ref":"#/components/parameters/Slippage"},{"$ref":"#/components/parameters/ChainQuery"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"chainId":{"type":"integer"},"tx":{"$ref":"#/components/schemas/Tx"},"preTransactions":{"$ref":"#/components/schemas/PreTransactions"},"gas":{"type":"string"},"route":{"type":"array","items":{"$ref":"#/components/schemas/RouteLeg"}},"priceImpact":{"type":"number","nullable":true},"vault":{"type":"object","properties":{"id":{"type":"string"},"address":{"type":"string"},"asset":{"type":"string","description":"Deposit asset address"},"assetSymbol":{"type":"string","nullable":true},"assetDecimals":{"type":"integer","nullable":true}}},"depositManager":{"type":"string"},"tokenIn":{"type":"string"},"amountIn":{"type":"string"},"slippageBps":{"type":"integer"},"swapped":{"type":"boolean","description":"`false` when tokenIn is already the deposit asset"},"deposit":{"type":"object","properties":{"token":{"type":"string"},"amount":{"type":"string","nullable":true,"description":"Base units actually deposited"},"minAmount":{"type":"string","nullable":true}}},"mintsSharesImmediately":{"type":"boolean","enum":[false]}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"503":{"$ref":"#/components/responses/NotConfigured"}}}}},"components":{"schemas":{"Address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"Tx":{"type":"object","properties":{"to":{"type":"string"},"from":{"type":"string"},"data":{"type":"string"},"value":{"type":"string"}}},"PreTransactions":{"type":"array","description":"Land these before `tx`.","items":{"type":"object","properties":{"type":{"type":"string"},"tx":{"$ref":"#/components/schemas/Tx"}}}},"RouteLeg":{"type":"object","properties":{"action":{"type":"string"},"protocol":{"type":"string"},"tokenIn":{"type":"array","items":{"type":"string"}},"tokenOut":{"type":"array","items":{"type":"string"}},"chainId":{"type":"integer"}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}},"additionalProperties":true}},"parameters":{"Slippage":{"name":"slippage","in":"query","required":false,"description":"Basis points, 0 to 5000. Default 100.","schema":{"type":"integer","minimum":0,"maximum":5000,"default":100}},"ChainQuery":{"name":"chain","in":"query","required":false,"description":"Chain name or id. Default `base`.","schema":{"type":"string","default":"base"}}},"responses":{"BadRequest":{"description":"Bad input.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotConfigured":{"description":"The feature is not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}
```

## Read-only JSON-RPC proxy

> A read-only JSON-RPC proxy to Syntetika's node providers. Accepts a single request or a batch of up to 20 (body max 64 KB) and only forwards allowed read methods. Calls that are not allowed get a JSON-RPC error in their slot; the rest are forwarded.\
> \
> Allowed methods: \`eth\_chainId\`, \`eth\_blockNumber\`, \`eth\_call\`, \`eth\_estimateGas\`, \`eth\_feeHistory\`, \`eth\_gasPrice\`, \`eth\_getBalance\`, \`eth\_getBlockByHash\`, \`eth\_getBlockByNumber\`, \`eth\_getCode\`, \`eth\_getLogs\`, \`eth\_getStorageAt\`, \`eth\_getTransactionByHash\`, \`eth\_getTransactionCount\`, \`eth\_getTransactionReceipt\`, \`eth\_maxPriorityFeePerGas\`, \`net\_version\`, \`web3\_clientVersion\`.<br>

```json
{"openapi":"3.0.3","info":{"title":"Syntetika Public API","version":"1.0.0"},"tags":[{"name":"RPC","description":"Read-only JSON-RPC proxy."}],"servers":[{"url":"https://public.api.syntetika.io"}],"paths":{"/rpc/{chain}":{"post":{"tags":["RPC"],"summary":"Read-only JSON-RPC proxy","description":"A read-only JSON-RPC proxy to Syntetika's node providers. Accepts a single request or a batch of up to 20 (body max 64 KB) and only forwards allowed read methods. Calls that are not allowed get a JSON-RPC error in their slot; the rest are forwarded.\n\nAllowed methods: `eth_chainId`, `eth_blockNumber`, `eth_call`, `eth_estimateGas`, `eth_feeHistory`, `eth_gasPrice`, `eth_getBalance`, `eth_getBlockByHash`, `eth_getBlockByNumber`, `eth_getCode`, `eth_getLogs`, `eth_getStorageAt`, `eth_getTransactionByHash`, `eth_getTransactionCount`, `eth_getTransactionReceipt`, `eth_maxPriorityFeePerGas`, `net_version`, `web3_clientVersion`.\n","operationId":"rpcProxy","parameters":[{"name":"chain","in":"path","required":true,"description":"`ethereum`, `base`, or `pharos` (only when configured). `404` for any other value.","schema":{"type":"string","enum":["ethereum","base","pharos"]}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/JsonRpcRequest"},{"type":"array","maxItems":20,"items":{"$ref":"#/components/schemas/JsonRpcRequest"}}]}}}},"responses":{"200":{"description":"The upstream node's JSON-RPC response, with its status code passed through. A rejected call is answered in place with a JSON-RPC error (`-32600` invalid request, `-32601` method not supported).","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/JsonRpcResponse"},{"type":"array","items":{"$ref":"#/components/schemas/JsonRpcResponse"}}]}}}},"404":{"$ref":"#/components/responses/NotFound"}}}}},"components":{"schemas":{"JsonRpcRequest":{"type":"object","required":["jsonrpc","id","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"integer"},{"type":"string"}]},"method":{"type":"string"},"params":{"type":"array","items":{}}}},"JsonRpcResponse":{"type":"object","properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{},"result":{},"error":{"type":"object","properties":{"code":{"type":"integer","description":"-32600 invalid request, -32601 method not supported"},"message":{"type":"string"}}}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}},"additionalProperties":true}},"responses":{"NotFound":{"description":"Not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}
```
