---
title: "CoinGecko tickers"
method: GET
path: "/api/tickers"
tags: ["CoinGecko"]
---

# CoinGecko tickers

`GET /api/tickers`

## Request

- Base URL: `https://market-api.metadao.fi/v1`
- URL: `https://market-api.metadao.fi/v1/api/tickers`
- Auth: one of:
  - none
  - API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/metadao/apis/futarchy-external-api/docs/api/tickers/get.ts> (a function with typed inputs; its response is checked against the schema)

One ticker per FutarchyAMM spot market. Price, spread and liquidity come from live pool reserves; 24h volume, high and low come from the served ETL. A market with no trades in the last 24h reports volume "0" and omits high/low. Returns 503 `SERVED_DB_UNAVAILABLE` when the served database is not connected, and 503 `SERVED_DATA_STALE` when the newest FutarchyAMM spot swap is older than the server's freshness limit (default 6h), rather than reporting volume that drains to zero behind a stalled pipeline.

## Response `200`

Array of tickers.

- CoinGeckoTicker[]
  - `ticker_id` string, required: `{base_currency}_{target_currency}`.
  - `base_currency` string, required: Base token mint.
  - `target_currency` string, required: Quote token mint.
  - `base_symbol` string
  - `base_name` string
  - `target_symbol` string
  - `target_name` string
  - `pool_id` string, required: DAO address.
  - `last_price` string, required: Mid price (quote per base) from pool reserves. Decimal string in human units.
  - `base_volume` string, required: Rolling 24h volume in the base token. Decimal string in human units.
  - `target_volume` string, required: Rolling 24h volume in the quote token. Decimal string in human units.
  - `liquidity_in_usd` string, required: Pool liquidity in USD. Decimal string in human units.
  - `bid` string, required: Bid price. Decimal string in human units.
  - `ask` string, required: Ask price. Decimal string in human units.
  - `high_24h` string: Rolling 24h high. Omitted when there were no trades. Decimal string in human units.
  - `low_24h` string: Rolling 24h low. Omitted when there were no trades. Decimal string in human units.
  - `treasury_usdc_aum` string: DAO treasury USDC holdings. Decimal string in human units.
  - `treasury_vault_address` string: DAO treasury vault address.
  - `startDate` string, date: First spot-trade day (YYYY-MM-DD).

## Other responses

- `400`: Invalid request: `INVALID_MINT_ADDRESS` for a bad path address, `INVALID_QUERY_PARAMETER` for a missing, malformed or repeated query parameter. `field` names the parameter.
- `401`: Unknown `X-API-Key` (`INVALID_API_KEY`), or missing/invalid metrics bearer token on `/metrics`.
- `429`: Rate limit exceeded (`RATE_LIMITED`).
- `500`: Unexpected server or upstream (RPC/DB) failure. Retry later.
- `503`: A dependency is unavailable or its data is stale (e.g. `SERVED_DB_UNAVAILABLE`, `SERVED_DATA_STALE`) or the request timed out (`REQUEST_TIMEOUT`). Retry later.

---

[API](https://skmtc.dev/metadao/apis/futarchy-external-api.md) - [All operations](https://skmtc.dev/metadao/apis/futarchy-external-api/llms.txt) - [OpenAPI document](https://skmtc.dev/metadao/apis/futarchy-external-api/revisions/27b09f0a2750?raw)