Chainlink
App · 5 actions
Read Chainlink's data feeds, the prices that DeFi apps rely on, straight from the blockchain: the latest ETH / USD or BTC / USD, several prices at once, the most recent updates with the high, low and change, or the price at any past moment. Browse the feeds on 25 networks, from Ethereum, Arbitrum and Base to Polygon and BNB Chain, covering crypto, currencies, stocks, commodities and proof of reserve. No account or API key required.
Actions
| Action | What it does |
|---|---|
| Get latest price | Get the current value of a Chainlink feed, such as the price of ETH in US dollars, read straight from its contract on chain, with when it was last updated and whether it is overdue. |
| Get price at a past time | Get the value a Chainlink feed showed at a moment in the past, such as ETH / USD at midnight on the last day of the quarter: the last update written at or before that time. |
| Get recent price updates | Get a feed's most recent updates, newest first, with the high, the low and how much the price moved across them: for spotting a sharp move or charting the last few hours. |
| Get several prices | Get the current values of several Chainlink feeds on one network in a single step: for a daily price summary or a dashboard. |
| List feeds | List the data feeds Chainlink publishes on a network: prices of crypto, currencies, stocks and commodities, proof-of-reserve and fund values, with how often each one updates. |
Get latest price
Get the current value of a Chainlink feed, such as the price of ETH in US dollars, read straight from its contract on chain, with when it was last updated and whether it is overdue. No API key required.
Inputs
- Network
networktextRequired - Which blockchain to read Chainlink's feeds on. Ethereum carries the widest choice; the same pair on another network is a separate feed with its own value.One of:
ethereum,arbitrum,avalanche,base,bnb(BNB Chain),bob,celo,gnosis(Gnosis Chain),hyperevm,ink, and 15 more. Default:ethereum. - Feed
feedtextRequired - The feed to read. Pick one, or type its name (ETH / USD), its short name (eth-usd) or its contract address.
Outputs
age_secondsnumber- How many seconds ago the value was written.
base_assettext- What is being priced, e.g. ETH. Null for feeds that aren't pairs.
contract_addresstext- The address of the feed's contract on the network.
decimalsnumber- How many decimal places the feed reports in. Already applied to every price here.
explorer_urltext- The feed's contract on the network's block explorer.
feed_idtext- Chainlink's short name for the feed, e.g. eth-usd. Null for a contract address Chainlink's feed list doesn't name.
feed_nametext- The feed's name, e.g. ETH / USD.
heartbeat_secondsnumber- The longest the feed goes without an update, in seconds, even when the price holds still. Null when Chainlink doesn't list one.
is_staletrue/false- True when the value is older than the feed's heartbeat, so the feed may have stopped updating. Stocks and other market-hours feeds go stale outside trading hours as a matter of course. Null when the heartbeat isn't known.
networktext- The network's key, e.g. ethereum. Any Network input takes it.
network_nametext- The network's name, e.g. Ethereum.
pricenumber- The value the feed reported, already scaled by its decimals, e.g. 2438.82 for ETH / USD.
quote_assettext- What the price is in, e.g. USD. Null for feeds that aren't pairs.
round_idtext- The id of the update on chain. Text, because it is too long for a number.
updated_attext- When the feed last wrote this value, in UTC (ISO 8601).
Example output
{
"age_seconds": 365,
"base_asset": "ETH",
"contract_address": "0x5f4eC3Df9cbd43714FE2740f5E3616155c5b8419",
"decimals": 8,
"explorer_url": "https://etherscan.io/address/0x5f4eC3Df9cbd43714FE2740f5E3616155c5b8419",
"feed_id": "eth-usd",
"feed_name": "ETH / USD",
"heartbeat_seconds": 3600,
"is_stale": false,
"network": "ethereum",
"network_name": "Ethereum",
"price": 2438.82147817,
"quote_asset": "USD",
"round_id": "129127208515966895990",
"updated_at": "2026-10-15T18:04:11Z"
}Get price at a past time
Get the value a Chainlink feed showed at a moment in the past, such as ETH / USD at midnight on the last day of the quarter: the last update written at or before that time. No API key required.
Inputs
- Network
networktextRequired - Which blockchain to read Chainlink's feeds on. Ethereum carries the widest choice; the same pair on another network is a separate feed with its own value.One of:
ethereum,arbitrum,avalanche,base,bnb(BNB Chain),bob,celo,gnosis(Gnosis Chain),hyperevm,ink, and 15 more. Default:ethereum. - Feed
feedtextRequired - The feed to read. Pick one, or type its name (ETH / USD), its short name (eth-usd) or its contract address.
- At
atdate and timeRequired - The moment to look up. Each feed's history on chain starts when Chainlink launched it, for ETH / USD on Ethereum in August 2020.
Outputs
base_assettext- What is being priced, e.g. ETH. Null for feeds that aren't pairs.
contract_addresstext- The address of the feed's contract on the network.
decimalsnumber- How many decimal places the feed reports in. Already applied to every price here.
explorer_urltext- The feed's contract on the network's block explorer.
feed_idtext- Chainlink's short name for the feed, e.g. eth-usd. Null for a contract address Chainlink's feed list doesn't name.
feed_nametext- The feed's name, e.g. ETH / USD.
heartbeat_secondsnumber- The longest the feed goes without an update, in seconds, even when the price holds still. Null when Chainlink doesn't list one.
networktext- The network's key, e.g. ethereum. Any Network input takes it.
network_nametext- The network's name, e.g. Ethereum.
pricenumber- The value the feed reported, already scaled by its decimals, e.g. 2438.82 for ETH / USD.
quote_assettext- What the price is in, e.g. USD. Null for feeds that aren't pairs.
requested_attext- The moment that was asked about, in UTC (ISO 8601).
round_idtext- The id of the update on chain. Text, because it is too long for a number.
seconds_before_requestednumber- How long before that moment this value was written: the value was current from updated_at until the feed's next update.
updated_attext- When the feed last wrote this value, in UTC (ISO 8601).
Example output
{
"base_asset": "ETH",
"contract_address": "0x5f4eC3Df9cbd43714FE2740f5E3616155c5b8419",
"decimals": 8,
"explorer_url": "https://etherscan.io/address/0x5f4eC3Df9cbd43714FE2740f5E3616155c5b8419",
"feed_id": "eth-usd",
"feed_name": "ETH / USD",
"heartbeat_seconds": 3600,
"network": "ethereum",
"network_name": "Ethereum",
"price": 2970.64,
"quote_asset": "USD",
"requested_at": "2026-01-01T00:00:00Z",
"round_id": "129127208515966884286",
"seconds_before_requested": 3109,
"updated_at": "2025-12-31T23:08:11Z"
}Get recent price updates
Get a feed's most recent updates, newest first, with the high, the low and how much the price moved across them: for spotting a sharp move or charting the last few hours. No API key required.
Inputs
- Network
networktextRequired - Which blockchain to read Chainlink's feeds on. Ethereum carries the widest choice; the same pair on another network is a separate feed with its own value.One of:
ethereum,arbitrum,avalanche,base,bnb(BNB Chain),bob,celo,gnosis(Gnosis Chain),hyperevm,ink, and 15 more. Default:ethereum. - Feed
feedtextRequired - The feed to read. Pick one, or type its name (ETH / USD), its short name (eth-usd) or its contract address.
- Number of updates
number_of_updatesnumber - Optional. How many of the latest updates to return, between 2 and 100; 10 by default. A feed updates at least once per heartbeat, so 24 updates of an hourly feed cover about a day.From 2 to 100. Default:
10.
Outputs
changenumber- Newest value minus the oldest one.
change_percentnumber- The change as a percentage of the oldest value, e.g. -1.25. Null when the oldest value is zero.
contract_addresstext- The address of the feed's contract on the network.
countnumber- How many updates came back. Fewer than asked only when the feed's readable history is shorter.
feed_idtext- Chainlink's short name for the feed, e.g. eth-usd. Null for a contract address Chainlink's feed list doesn't name.
feed_nametext- The feed's name, e.g. ETH / USD.
from_timetext- When the oldest update was written (UTC).
highest_pricenumber- The highest value in the list.
latest_pricenumber- The newest value.
lowest_pricenumber- The lowest value in the list.
networktext- The network's key, e.g. ethereum. Any Network input takes it.
network_nametext- The network's name, e.g. Ethereum.
oldest_pricenumber- The oldest value in the list.
to_timetext- When the newest update was written (UTC).
updateslist- The updates, newest first.
Example output
{
"change": -12.34689533,
"change_percent": -0.5037,
"contract_address": "0x5f4eC3Df9cbd43714FE2740f5E3616155c5b8419",
"count": 2,
"feed_id": "eth-usd",
"feed_name": "ETH / USD",
"from_time": "2026-10-15T17:19:11Z",
"highest_price": 2451.1683735,
"latest_price": 2438.82147817,
"lowest_price": 2438.82147817,
"network": "ethereum",
"network_name": "Ethereum",
"oldest_price": 2451.1683735,
"to_time": "2026-10-15T18:04:11Z",
"updates": [
{
"price": 2438.82147817,
"round_id": "129127208515966895990",
"updated_at": "2026-10-15T18:04:11Z"
},
{
"price": 2451.1683735,
"round_id": "129127208515966895989",
"updated_at": "2026-10-15T17:19:11Z"
}
]
}Get several prices
Get the current values of several Chainlink feeds on one network in a single step: for a daily price summary or a dashboard. No API key required.
Inputs
- Network
networktextRequired - Which blockchain to read Chainlink's feeds on. Ethereum carries the widest choice; the same pair on another network is a separate feed with its own value.One of:
ethereum,arbitrum,avalanche,base,bnb(BNB Chain),bob,celo,gnosis(Gnosis Chain),hyperevm,ink, and 15 more. Default:ethereum. - Feeds
feedslistRequired - The feeds to read, up to 20. Pick them, or type names (BTC / USD), short names (btc-usd) or contract addresses.
Outputs
countnumber- How many feeds were read.
networktext- The network's key, e.g. ethereum. Any Network input takes it.
network_nametext- The network's name, e.g. Ethereum.
priceslist- One entry per feed, in the order asked for.
Example output
{
"count": 2,
"network": "ethereum",
"network_name": "Ethereum",
"prices": [
{
"age_seconds": 365,
"base_asset": "ETH",
"contract_address": "0x5f4eC3Df9cbd43714FE2740f5E3616155c5b8419",
"decimals": 8,
"explorer_url": "https://etherscan.io/address/0x5f4eC3Df9cbd43714FE2740f5E3616155c5b8419",
"feed_id": "eth-usd",
"feed_name": "ETH / USD",
"heartbeat_seconds": 3600,
"is_stale": false,
"network": "ethereum",
"network_name": "Ethereum",
"price": 2438.82147817,
"quote_asset": "USD",
"round_id": "129127208515966895990",
"updated_at": "2026-10-15T18:04:11Z"
},
{
"age_seconds": 71,
"base_asset": "BTC",
"contract_address": "0xF4030086522a5bEEa4988F8cA5B36dbC97BeE88c",
"decimals": 8,
"explorer_url": "https://etherscan.io/address/0xF4030086522a5bEEa4988F8cA5B36dbC97BeE88c",
"feed_id": "btc-usd",
"feed_name": "BTC / USD",
"heartbeat_seconds": 3600,
"is_stale": false,
"network": "ethereum",
"network_name": "Ethereum",
"price": 82206.31790204,
"quote_asset": "USD",
"round_id": "129127208515966880112",
"updated_at": "2026-10-15T18:09:05Z"
}
]
}List feeds
List the data feeds Chainlink publishes on a network: prices of crypto, currencies, stocks and commodities, proof-of-reserve and fund values, with how often each one updates. Search by name or narrow by kind. No API key required.
Inputs
- Network
networktextRequired - Which blockchain to read Chainlink's feeds on. Ethereum carries the widest choice; the same pair on another network is a separate feed with its own value.One of:
ethereum,arbitrum,avalanche,base,bnb(BNB Chain),bob,celo,gnosis(Gnosis Chain),hyperevm,ink, and 15 more. Default:ethereum. - Search
searchtext - Optional. Only feeds whose name or asset contains this text. Capitals and spaces are ignored, so eth/usd finds ETH / USD.
- Kind of feed
feed_kindtext - Optional. Only feeds that report this kind of value. Leave empty for every kind.One of:
price(Prices and exchange rates),proof_of_reserve(Proof of reserve),fund_value(Fund values (NAV)),economic(Economic data),other(Everything else). - Asset type
asset_classtext - Optional. Only feeds about this type of asset. Leave empty for every type.One of:
crypto,currency(Currencies (forex)),stock(Stocks and ETFs),commodity(Commodities),other(Everything else). - Number of feeds
limitnumber - Optional. The most feeds to return, A to Z by name. Between 1 and 500; 100 by default.From 1 to 500. Default:
100.
Outputs
countnumber- How many feeds are in this list.
feedslist- The matching feeds, A to Z by name.
has_moretrue/false- True when more feeds matched than were returned. Raise Number of feeds or narrow the search.
networktext- The network's key, e.g. ethereum. Any Network input takes it.
network_nametext- The network's name, e.g. Ethereum.
total_countnumber- How many feeds matched in all.
Example output
{
"count": 1,
"feeds": [
{
"asset_class": "crypto",
"asset_name": "Ethereum",
"base_asset": "ETH",
"contract_address": "0x5f4eC3Df9cbd43714FE2740f5E3616155c5b8419",
"decimals": 8,
"deviation_threshold_percent": 0.5,
"explorer_url": "https://etherscan.io/address/0x5f4eC3Df9cbd43714FE2740f5E3616155c5b8419",
"feed_id": "eth-usd",
"feed_kind": "price",
"heartbeat_seconds": 3600,
"is_being_retired": false,
"market_hours": "Crypto",
"market_risk": "Low",
"name": "ETH / USD",
"network": "ethereum",
"network_name": "Ethereum",
"quote_asset": "USD",
"retirement_date": null
}
],
"has_more": false,
"network": "ethereum",
"network_name": "Ethereum",
"total_count": 1
}