> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trusset.org/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Oracle History
> List recorded price attestations beside the prices that landed on the oracle
Returns two lists, newest first. `signed` holds the price attestations recorded for the market, through [Record Price Attestation](/endpoints/lending/record-price-attestation) or the Trusset app. `pushed` holds every price that actually landed on the oracle, read from its `PriceUpdated` events. An attestation that has landed carries the `pushedTxHash` of the transaction that landed it.
Neither list is complete on its own. `signed` shows only attestations someone recorded; a signature from [Sign Price](/endpoints/lending/sign-price) that was never recorded is absent. `pushed` never holds the price set at deployment, which emits no event. An `ORACLE`-priced market reads an external feed, so its `pushed` list stays empty.
## How the Pushed List Stays Current
Each read first sweeps the oracle's events forward from where the last sweep stopped, then answers from the stored rows. The first sweep starts at the deployment block, or 200,000 blocks back when the deployment transaction is not on record. The sweep stays 3 blocks behind the chain head, so a push from the last few blocks may not appear yet. It runs at most once every 15 seconds per market and reads at most 400 events per run, so a long backlog can take several reads to catch up. A failed sweep leaves the stored rows unchanged and the read still answers.
## Path Parameters
Market ID.
## Query Parameters
Entries per list, from 1 to 100. Values above 100 are lowered to 100; zero or a non-numeric value falls back to 20.
## Response Fields
Recorded attestations, newest signed timestamp first.
Attestation ID.
The attested price as a decimal string.
The same price in base units.
The signed timestamp, as an ISO 8601 string.
The signed expiry, as an ISO 8601 string.
The key that signed.
`API` or `APP`, the face it was recorded through.
The transaction that landed this attestation, or `null`.
When that transaction was mined, or `null`.
Prices that landed on the oracle, newest block first.
Row ID.
The new price as a decimal string.
The same price in base units.
The price it replaced, as a decimal string.
The wallet that sent a pushed price, or the key that signed a signed price.
The transaction that landed it.
Its block.
The block's time, as an ISO 8601 string.
The block the event mirror had reached when this read started, before its own sweep. `null` before the first sweep.
The borrow asset's symbol, or `null`.
```bash cURL theme={null}
curl "https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/oracle-history?limit=20" \
-H "X-API-Key: trusset_your_key_here"
```
```typescript TypeScript theme={null}
const res = await fetch(
`https://api.trusset.org/lending-external-securities-v2/api/markets/${marketId}/oracle-history?limit=20`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
```
```json Response theme={null}
{
"success": true,
"data": {
"signed": [
{
"id": "clx4k2p9e0001m8tq3v7h5z2a",
"price": "105.4",
"priceWei": "105400000",
"attestedAt": "2024-06-15T10:00:00.000Z",
"validUntil": "2024-06-15T10:05:00.000Z",
"signer": "0x9c1e57a2d0b34f86e7a15c9d2b4f60e38a7d4b70",
"source": "API",
"pushedTxHash": "0x9f2c41d8b7e05a3164c2870fbd935e1a4c7802db6135ea9048f7c21b5d3ea41b",
"pushedAt": "2024-06-15T10:01:12.000Z"
}
],
"pushed": [
{
"id": "clx4k3a1f0004m8tq9c2d6e1b",
"price": "105.4",
"priceWei": "105400000",
"previousPrice": "104.82",
"updater": "0x9c1e57a2d0b34f86e7a15c9d2b4f60e38a7d4b70",
"txHash": "0x9f2c41d8b7e05a3164c2870fbd935e1a4c7802db6135ea9048f7c21b5d3ea41b",
"blockNumber": 6120451,
"pushedAt": "2024-06-15T10:01:12.000Z"
}
],
"syncedBlock": 6120448,
"settlementSymbol": "USDC"
}
}
```
```json Error - No Oracle theme={null}
{
"success": false,
"error": {
"code": "NO_ORACLE",
"message": "No oracle is configured for this market"
}
}
```
## Error Codes
| Code | HTTP | Cause |
| ----------------------- | ----- | --------------------------------------------------------------- |
| `NO_ORACLE` | `400` | The market records no oracle address |
| `MISSING_MARKET_ID` | `400` | `marketId` is longer than 100 characters |
| `MARKET_NOT_FOUND` | `404` | No market with this ID on your instance |
| `ORACLE_HISTORY_FAILED` | `500` | The history could not be read and no more specific code applied |