Pair Data

Pair endpoints expose metadata for a pair and audit breakdowns (single or batch) including developer, top holders, insiders, bundlers, snipers, and LP burn distribution.

Get Metadata for Pair

get

Returns the underlying token metadata for a given pair address. Social fields are omitted.

Path parameters

pairAddressstringRequired

The pair address (e.g., liquidity pool address)

Responses

200

Pair metadata returned successfully

application/json

400

Missing or invalid pair address

application/json

404

Pair or token not found

application/json

500

Unexpected server error

application/json

get

/pairs/{pairAddress}/metadata

HTTPcURLJavaScriptPython

GET /pairs/{pairAddress}/metadata HTTP/1.1
Accept: */*

{
  "data": {
    "tokenName": "Token Name",
    "tokenSymbol": "TOKEN",
    "tokenDescription": "Example token behind the pair",
    "tokenImage": "https://example.com/token.png",
    "tokenSupply": 1000000,
    "tokenDecimals": 9,
    "devWallet": "ABC123...",
    "createdAt": "2025-07-15T00:00:00Z",
    "graduatedAt": "2025-07-16T00:00:00Z",
    "basePool": "BasePoolAddress",
    "quotePool": "QuotePoolAddress",
    "pairAddresses": [
      "9z5HnczUuGxAbf1h7yA3QZPjrfK8M2Wp12yYkE7tLJbD",
      "8aLm8K4Y4TdxP5vsmg8JXbK8svDqY1N9aEz21X4vhsXc"
    ]
  },
  "meta": {
    "pairAddress": "9z5HnczUuGxAbf1h7yA3QZPjrfK8M2Wp12yYkE7tLJbD",
    "tokenAddress": "52Es35QASGKbYfJBezqFiyWBkbX384KRjWafaoKcpump"
  }
}

Get Pair Audit

get

Returns audit data for a single liquidity pair and its underlying token. Includes token-level distribution (developer, top holders, insiders, bundlers) and pair-level ownership breakdown (snipers, LP burn).

Path parameters

pairAddressstringRequired

The pair address (e.g., liquidity pool address)

Responses

200

Pair audit data returned successfully

application/json

400

Missing or invalid pairAddress

application/json

404

Pair not found

application/json

500

Internal server error

application/json

get

/pairs/{pairAddress}/audit

HTTPcURLJavaScriptPython

GET /pairs/{pairAddress}/audit HTTP/1.1
Accept: */*

{
  "data": {
    "tokenSupply": 1000000,
    "developer": {
      "tokenSupply": 102000,
      "percent": 10.2,
      "walletAddress": "C9fjP4xqM2k8PnRftz1234abcXYZ..."
    },
    "top10Holders": {
      "tokenSupply": 705000,
      "percent": 70.5
    },
    "insiders": {
      "tokenSupply": 19000,
      "percent": 1.9
    },
    "bundlers": {
      "tokenSupply": 28000,
      "percent": 2.8
    },
    "snipers": {
      "tokenSupply": 11000,
      "percent": 1.1
    },
    "lpBurn": {
      "tokenSupply": 40000,
      "percent": 4
    }
  },
  "meta": {
    "pairAddress": "9z5HnczUuGxAbf1h7yA3QZPjrfK8M2Wp12yYkE7tLJbD",
    "tokenAddress": "So11111111111111111111111111111111111111112"
  }
}

Get Pair Audit (Multiple)

get

Returns audit data for multiple liquidity pairs in a single batch call. Accepts up to 10 pair addresses via the addresses query parameter. Each entry includes pair-level and token-level audit details including developer, top holders, insiders, bundlers, snipers, and LP burn distribution.

Cost: 10 credits per request.

Query parameters

addressesstringRequired

Comma-separated list of up to 10 pair addresses

Example: pairAddress1,pairAddress2

Responses

200

Batch pair audit data returned successfully

application/json

400

Missing or invalid query parameter

application/json

500

Internal server error

application/json

get

/pairs/audit

HTTPcURLJavaScriptPython

GET /pairs/audit?addresses=pairAddress1%2CpairAddress2 HTTP/1.1
Accept: */*

{
  "data": {
    "addresses": [
      "9z5HnczUuGxAbf1h7yA3QZPjrfK8M2Wp12yYkE7tLJbD",
      "8aLm8K4Y4TdxP5vsmg8JXbK8svDqY1N9aEz21X4vhsXc"
    ],
    "pairs": [
      {
        "pairAddress": "9z5HnczUuGxAbf1h7yA3QZPjrfK8M2Wp12yYkE7tLJbD",
        "tokenAddress": "So11111111111111111111111111111111111111112",
        "tokenSupply": 1000000,
        "developer": {
          "tokenSupply": 105000,
          "percent": 10.5,
          "walletAddress": "F7Rk2x3PT6ZC3XnKk9bAopYfM1s4W8JZTqgA1Yj2uCVZ"
        },
        "top10Holders": {
          "tokenSupply": 720000,
          "percent": 72
        },
        "insiders": {
          "tokenSupply": 18000,
          "percent": 1.8
        },
        "bundlers": {
          "tokenSupply": 23000,
          "percent": 2.3
        },
        "snipers": {
          "tokenSupply": 9000,
          "percent": 0.9
        },
        "lpBurn": {
          "tokenSupply": 35000,
          "percent": 3.5
        }
      },
      {
        "pairAddress": "8aLm8K4Y4TdxP5vsmg8JXbK8svDqY1N9aEz21X4vhsXc",
        "tokenAddress": "So11111111111111111111111111111111111111112",
        "tokenSupply": 2500000,
        "developer": {
          "tokenSupply": 200000,
          "percent": 8,
          "walletAddress": "C4HkR5aN2dF3V8JZT..."
        },
        "top10Holders": {
          "tokenSupply": 1850000,
          "percent": 74
        },
        "insiders": {
          "tokenSupply": 22000,
          "percent": 2.2
        },
        "bundlers": {
          "tokenSupply": 30000,
          "percent": 3
        },
        "snipers": {
          "tokenSupply": 15000,
          "percent": 1.5
        },
        "lpBurn": {
          "tokenSupply": 41000,
          "percent": 4.1
        }
      }
    ]
  },
  "meta": {
    "count": 2
  }
}