OpenAPI Specification
openapi: 3.0.0
info:
title: Linea Token Prices API
description: API to access token information on Linea, including prices, traded tokens and top movers over 24h.
version: 0.1.0
contact: {}
servers:
- url: https://token-api.linea.build
description: Linea Token API production server
tags:
- name: Prices
description: Token price history
paths:
/prices/{contractAddress}:
get:
description: Retrieve hourly prices over the last 24 hours for a single token
operationId: PricesController_findOne
parameters:
- name: contractAddress
required: true
in: path
description: The Ethereum contract address of the token
schema:
type: string
responses:
'200':
description: Successfully retrieved prices
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/PriceResponseDto'
'400':
description: Invalid contract address format
'404':
description: Token not found
summary: Get hourly prices for a token
tags:
- Prices
/prices:
get:
description: Retrieve hourly prices over the last 24 hours for multiple tokens
operationId: PricesController_findMany
parameters:
- name: addresses
required: true
in: query
description: List of token contract addresses (comma-separated, max 100)
schema:
maxItems: 100
type: string
responses:
'200':
description: Successfully retrieved prices
content:
application/json:
schema:
type: object
description: Map of contract address to price history array
summary: Get hourly prices for multiple tokens
tags:
- Prices
components:
schemas:
PriceResponseDto:
type: object
properties:
price:
type: number
example: 1
description: Price in USD at a given date and time
timestamp:
format: date-time
type: string
example: '2026-05-19T13:38:03.784Z'
description: Date and time when the price was fetched
required:
- price
- timestamp