---
title: "Pair metadata"
method: GET
path: "/dexscreener/pair"
tags: ["DexScreener"]
---

# Pair metadata

`GET /dexscreener/pair`

## Request

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

Pair identity and creation block (first spot swap). Cached server-side for 5 minutes. 404 when the DAO has no spot swaps.

## Query parameters

- `id` string, required: Solana public key (base58).

## Response `200`

Pair.

- DexScreenerPairResponse
  - `pair` DexScreenerPair, required
    - `id` string, required: DAO address.
    - `dexKey` 'futarchyAMM', required
    - `asset0Id` string, required: Base token mint.
    - `asset1Id` string, required: Quote token mint.
    - `feeBps` integer, required: Protocol fee in basis points (e.g. 50).
    - `createdAtBlockNumber` integer, required: Slot of the first spot swap.
    - `createdAtBlockTimestamp` integer, required: Unix seconds.
    - `createdAtTxnId` string, required: Signature of the first spot swap.

## 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`.
- `404`: No matching data (`NOT_FOUND`: "Pair not found" / "No blocks available").
- `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)