HTTP API reference › GalaSwap DEX › market
GalaSwap DEX — market
7 operations in this group.
- GET /market/token-series — Normalized USD OHLCV + current price for a token at a timeframe
- GET /market/price — Normalized { price, change24h } per asset id, keyed by registry symbol and also by each requested id that is not the symbol
- GET /market/price-series — Dense USD price line for a token (pair-ratio denominator)
- GET /market/sparkline — 7-day mini sparkline (in-house daily close prices)
- GET /market/images — Token logo URLs keyed by symbol (CoinGecko coins/markets)
- GET /market/wallet-transactions — ChainMeter wallet transaction history (raw get_wallet_txs rows)
- GET /market/wallet-swaps — A wallet’s swaps from our own indexed trades (legacy and new contract), newest first, in the get_wallet_txs row shape the My Swaps history parses
GET /market/token-series
MarketController_tokenSeries
Normalized USD OHLCV + current price for a token at a timeframe
Normalized USD OHLCV + current price for a token at a timeframe
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| timeframe | query | required | string enum: 1D, 1W, 1M, 1Y, ALL | Chart timeframe |
| token | query | required | Token symbol or $-composite tokenClassKey |
Responses
200 —
Content type: application/json
Schema: MarketTokenSeriesResponseDto
| Field | Type | Required | Description |
|---|---|---|---|
| ohlcv | array<MarketOhlcvPointResponseDto> | yes | |
| currentPrice | number nullable | yes | |
| change24h | number nullable | yes | |
| volume24h | number nullable | yes | |
| source | string enum: inhouse, coingecko, chainmeter, none | yes |
400 —
Content type: application/json
Schema: MarketErrorResponseDto
| Field | Type | Required | Description |
|---|---|---|---|
| status | boolean | yes | |
| message | string | yes |
default — An error response using the shared backend error envelope.
Content type: application/json
Schema: ApiErrorEnvelope
| Field | Type | Required | Description |
|---|---|---|---|
| status | integer | yes | |
| error | boolean | yes | |
| message | string | yes | |
| errorKey | string | no |
Example response
[]
GET /market/price
MarketController_price
Normalized { price, change24h } per asset id, keyed by registry symbol and also by each requested id that is not the symbol
Normalized { price, change24h } per asset id, keyed by registry symbol and also by each requested id that is not the symbol
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| assetIds | query | required | Comma-separated asset ids |
Responses
200 —
Content type: application/json
Schema: object
| Field | Type | Required | Description |
|---|---|---|---|
| additionalProperties.price | number nullable | yes | |
| additionalProperties.change24h | number nullable | yes | |
| additionalProperties.listed | boolean | yes |
400 —
Content type: application/json
Schema: MarketErrorResponseDto
| Field | Type | Required | Description |
|---|---|---|---|
| status | boolean | yes | |
| message | string | yes |
default — An error response using the shared backend error envelope.
Content type: application/json
Schema: ApiErrorEnvelope
| Field | Type | Required | Description |
|---|---|---|---|
| status | integer | yes | |
| error | boolean | yes | |
| message | string | yes | |
| errorKey | string | no |
Example response
[]
GET /market/price-series
MarketController_priceSeries
Dense USD price line for a token (pair-ratio denominator)
Dense USD price line for a token (pair-ratio denominator)
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| timeframe | query | required | string enum: 1D, 1W, 1M, 1Y, ALL | Chart timeframe |
| token | query | required | Token symbol or $-composite tokenClassKey |
Responses
200 —
Content type: application/json
Schema: MarketPriceSeriesResponseDto
| Field | Type | Required | Description |
|---|---|---|---|
| prices | array<MarketPriceSeriesPointResponseDto> | yes | |
| currentPrice | number nullable | yes | |
| change24h | number nullable | yes |
400 —
Content type: application/json
Schema: MarketErrorResponseDto
| Field | Type | Required | Description |
|---|---|---|---|
| status | boolean | yes | |
| message | string | yes |
default — An error response using the shared backend error envelope.
Content type: application/json
Schema: ApiErrorEnvelope
| Field | Type | Required | Description |
|---|---|---|---|
| status | integer | yes | |
| error | boolean | yes | |
| message | string | yes | |
| errorKey | string | no |
Example response
[]
GET /market/sparkline
MarketController_sparkline
7-day mini sparkline (in-house daily close prices)
7-day mini sparkline (in-house daily close prices)
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| token | query | required | Token symbol or $-composite tokenClassKey |
Responses
200 —
Content type: application/json
Schema: array<number>
| Field | Type | Required | Description |
|---|---|---|---|
| items.value | number | no |
400 —
Content type: application/json
Schema: MarketErrorResponseDto
| Field | Type | Required | Description |
|---|---|---|---|
| status | boolean | yes | |
| message | string | yes |
default — An error response using the shared backend error envelope.
Content type: application/json
Schema: ApiErrorEnvelope
| Field | Type | Required | Description |
|---|---|---|---|
| status | integer | yes | |
| error | boolean | yes | |
| message | string | yes | |
| errorKey | string | no |
Example response
[]
GET /market/images
MarketController_images
Token logo URLs keyed by symbol (CoinGecko coins/markets)
Token logo URLs keyed by symbol (CoinGecko coins/markets)
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| tokens | query | required | Comma-separated token symbols |
Responses
200 —
Content type: application/json
Schema: object
| Field | Type | Required | Description |
|---|---|---|---|
| additionalProperties.value | string | no |
400 —
Content type: application/json
Schema: MarketErrorResponseDto
| Field | Type | Required | Description |
|---|---|---|---|
| status | boolean | yes | |
| message | string | yes |
default — An error response using the shared backend error envelope.
Content type: application/json
Schema: ApiErrorEnvelope
| Field | Type | Required | Description |
|---|---|---|---|
| status | integer | yes | |
| error | boolean | yes | |
| message | string | yes | |
| errorKey | string | no |
Example response
[]
GET /market/wallet-transactions
MarketController_walletTransactions
ChainMeter wallet transaction history (raw get_wallet_txs rows)
ChainMeter wallet transaction history (raw get_wallet_txs rows)
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| size | query | optional | Page size (max 100) | |
| page | query | optional | Zero-based page | |
| address | query | required | Wallet address, e.g. eth|<hex> or client|<id> |
Responses
200 —
Content type: application/json
Schema: array<object>
| Field | Type | Required | Description |
|---|---|---|---|
| items.* | free-form object | no | Additional properties allowed |
400 —
Content type: application/json
Schema: MarketErrorResponseDto
| Field | Type | Required | Description |
|---|---|---|---|
| status | boolean | yes | |
| message | string | yes |
502 —
Content type: application/json
Schema: MarketErrorResponseDto
| Field | Type | Required | Description |
|---|---|---|---|
| status | boolean | yes | |
| message | string | yes |
default — An error response using the shared backend error envelope.
Content type: application/json
Schema: ApiErrorEnvelope
| Field | Type | Required | Description |
|---|---|---|---|
| status | integer | yes | |
| error | boolean | yes | |
| message | string | yes | |
| errorKey | string | no |
Example response
[]
GET /market/wallet-swaps
MarketController_walletSwaps
A wallet’s swaps from our own indexed trades (legacy and new contract), newest first, in the get_wallet_txs row shape the My Swaps history parses
A wallet’s swaps from our own indexed trades (legacy and new contract), newest first, in the get_wallet_txs row shape the My Swaps history parses
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| size | query | optional | Page size (max 100) | |
| page | query | optional | Zero-based page | |
| address | query | required | Comma-separated wallet addresses to match (at most 3), e.g. client|<id>,eth|<hex>. A registered wallet’s legacy swaps are recorded under its eth| signer and its new-contract swaps under its client| alias, so send both. |
Responses
200 —
Content type: application/json
Schema: array<MarketWalletSwapResponseDto>
| Field | Type | Required | Description |
|---|---|---|---|
| items.block_number | number | yes | |
| items.tx_number | string | yes | |
| items.created_at | string (date-time) | yes | |
| items.creator | string | yes | |
| items.sender | string | yes | |
| items.recipient | string | yes | |
| items.tx_type | string enum: GalaChainDex:Trade, DexV3Contract:Swap | yes | |
| items.tx_subtype | string enum: Swap | yes | |
| items.quantity | number | yes | |
| items.tx_validation_code | string enum: 0 | yes | |
| items.tx_validation_enum | string enum: VALID | yes | |
| items.usd_volume | number | yes | |
| items.swap_token_0_amt | number | yes | |
| items.swap_token_1_amt | number | yes | |
| items.swap_token_0_name | string nullable | yes | |
| items.swap_token_1_name | string nullable | yes | |
| items.swap_token_0_image | string nullable | yes | |
| items.swap_token_1_image | string nullable | yes | |
| items.swap_token_0_asset_id | string nullable | yes | |
| items.swap_token_1_asset_id | string nullable | yes | |
| items.unique_key | string | yes | |
| items.pool_hash | string | yes |
400 —
Content type: application/json
Schema: MarketErrorResponseDto
| Field | Type | Required | Description |
|---|---|---|---|
| status | boolean | yes | |
| message | string | yes |
default — An error response using the shared backend error envelope.
Content type: application/json
Schema: ApiErrorEnvelope
| Field | Type | Required | Description |
|---|---|---|---|
| status | integer | yes | |
| error | boolean | yes | |
| message | string | yes | |
| errorKey | string | no |
Example response
[]
Previous group: token-class · Next group: marketplace