Skip to main content
GET
/
v1
/
history
/
{vault_id}
Get vault share price history
curl --request GET \
  --url https://api.byzantine.fi/v1/history/{vault_id} \
  --header 'X-Pubkey: <api-key>' \
  --header 'X-Signature: <x-signature>' \
  --header 'X-Timestamp: <x-timestamp>'
{
  "vault_id": "<string>",
  "data": [
    {
      "timestamp": "2023-11-07T05:31:56Z",
      "share_price": 123,
      "total_assets": 123,
      "hourly_apy": 123
    }
  ],
  "total_count": 123
}

Authorizations

​
X-Pubkey
string
header
required

Integrator's ECDSA public key (P-256 curve, compressed SEC1 format). Example: 0x038fedef7c12f93bbf342ad8943b7a825a3b41f61c9dc118b2c718efebabbf62fd

Headers

​
X-Timestamp
string
required

Unix timestamp in seconds (UTC). Must be within tolerance window (1 minute) to prevent replay attacks. Example: 1760375826

​
X-Signature
string
required

ECDSA signature (DER-encoded, hex with 0x prefix). Signs the message: {timestamp}{METHOD}{path_and_query}{json_body}. Example: 0x3045022100...

Path Parameters

​
vault_id
string
required

Vault ID

Query Parameters

​
start_date
string<date-time> | null

Start date for history

​
end_date
string<date-time> | null

End date for history

​
limit
integer | null

Limit number of results (default: 1000)

​
offset
integer | null

Offset for pagination (default: 0)

​
order
string | null

Order by timestamp: asc or desc (default: asc)

Response

Historical data retrieved successfully

​
vault_id
string
required
​
data
object[]
required
​
total_count
integer
required