Protocols

Get protocol TVL

Blend is the only supported protocol for this surface, at `1d` resolution only (`1h` and `1w` are reserved and return 400). Live mode supports `from`/`to` range filters and point-in-time reads via `as_of_ledger`; fixture mode supports `from`/`to` but rejects `as_of_ledger` with 501. Recognised but unsupported protocols (aquarius, soroswap, fxdao) return 501 naming the protocol and surface; unknown protocol ids return 404.

GET
/v1/protocols/{id}/tvl

Blend is the only supported protocol for this surface, at 1d resolution only (1h and 1w are reserved and return 400). Live mode supports from/to range filters and point-in-time reads via as_of_ledger; fixture mode supports from/to but rejects as_of_ledger with 501. Recognised but unsupported protocols (aquarius, soroswap, fxdao) return 501 naming the protocol and surface; unknown protocol ids return 404.

Authorization

OrionApiKey
x-orion-token<token>

In: header

Path Parameters

id*string

Protocol id

Value in

  • "blend"
  • "aquarius"
  • "soroswap"
  • "fxdao"

Query Parameters

from?string

Inclusive range start (RFC 3339).

Formatdate-time
to?string

Inclusive range end (RFC 3339).

Formatdate-time
resolution?string

Bucket size. Only "1d" is currently supported; "1h" and "1w" are reserved and return 400.

Value in

  • "1h"
  • "1d"
  • "1w"
as_of_ledger?integer

Return data as of this ledger sequence number. Omit for latest state.

Formatint64
Range0 <= value

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/protocols/blend/tvl"
{  "data": {    "points": [      {        "timestamp": "2019-08-24T14:15:22Z",        "tvl_usd": "string"      }    ],    "protocol_id": "string",    "resolution": "1h"  },  "enrichment": {    "assets": {      "property1": {        "decimals": 0,        "price_source": null,        "price_usd": "string",        "symbol": "string",        "tags": [          "string"        ]      },      "property2": {        "decimals": 0,        "price_source": null,        "price_usd": "string",        "symbol": "string",        "tags": [          "string"        ]      }    },    "contracts": {      "property1": {        "name": "string",        "position_types": [          "collateral"        ],        "protocol": "string",        "status": "active",        "version": "string"      },      "property2": {        "name": "string",        "position_types": [          "collateral"        ],        "protocol": "string",        "status": "active",        "version": "string"      }    }  },  "meta": {    "as_of_ledger": 0,    "attribution_confidence": 0,    "data_staleness_seconds": 0,    "last_indexed_ledger": 0,    "ledger_lag_seconds": 0,    "oracle_staleness_seconds": 0,    "partial_result": true,    "requested_ledger": 0,    "response_time_ms": 0,    "sources": [      "soroban_rpc"    ]  }}

Get protocol reservesget

Blend is the only supported protocol for this surface. Live mode serves the latest reserves and point-in-time reads via `as_of_ledger`; fixture mode is latest-only and rejects `as_of_ledger` with 501. Recognised but unsupported protocols (aquarius, soroswap, fxdao) return 501 naming the protocol and surface; unknown protocol ids return 404.

Get transactionget

`meta.partial_result` semantics: the flag is true when the decode may be incomplete — specifically when (a) any protocol referenced by the transaction's activities has a missing or unhealthy indexing adapter, (b) normalized activity rows exist but the transaction record itself has not been indexed yet, or (c) the transaction record exists but produced no normalized activity rows. It is false only when the transaction record and at least one activity row are both present and every involved protocol's adapter is healthy.